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Preface 



I 



The information in this publication is of 
particular interest to anyone responsible 
for the planning and/or iniplerr:entation of 
system generation and maintenance for 
DOS/VS. This includes installation 
managers, system analysts, prograirirers, and 
machine operators. 



Familiarity with the following system 
programs and facilities is invaluable when 
using this publication: 



the control programs (supervisor, job 
control, and IPL) , 



the system service prograirs (linkage 
editor and librarian) and 



• the Input/Output Control Systerr (IOCS) 
logic modules. 

The storage estimates given in this 
publication are within 15% of actual 
requirements. 



MODULAR ORGANIZATION OF THIS MANUAL 

This publication is in a modular format 
that enables you to discard unwanted 
modules and to insert system generation 
modules from program product documents. 
Thus, you can tailor your system generation 
document for your installation. 

Although the pages are numbered 
consecutively throughout the book, each 
module is a self-contained document. A 
numbered tab on the right-hand edge of the 
page indicates the beginning of each new 
module. Each module has a Module Outline 
and, where length warrants, a Mo du le Index. 

The total publication has a General 
Contents and a General Index. These refer 
you to the individual module numbers. 
Figure numbers throughout the publication 
are in the form: Figure 1-3, where 1 is 
the module number and 3 is the figure 
number within the module. 



Each m,odule in this publication is a 
collection of information about a 
particular component or related topics. 

The modules, numbered from 1 to 23, are 
grouped as follows: 



Module 1: Planning and procedures 
information 

Module 2: Generating a version of POWER 

Module 3: Installation Verification 
Procedures (IVP) 

Modules 4-6: Emulator Programs 

Modules 7-16: I/O Components 



Module 17 
Module 18 
Module 19 
Module 20 
Module 21 
Module 2 2 
Module 2 3 



VSAM 

Assembler 

System aids (OLTEP) 

BTAM 

QTAM 

System Utilities 

EREP 



Prerequisites for a thorough understanding 
and for the effective use of this 
publication are: 



DOS/VS System Management Guide , GC33-5371 

DOS/VS System Control Statements , GC33-5376 

DOS/VS Supervisor S I/O Macros , GC33-5373 
DOS/VS Operating Procedures , GC33-5378 
DOS/VS Messages, GC 33-5379 
DOS/VS System Utilities, GC 33-5381 



General Contents 



MODULE 1: PLANNING AND PROCEDURES ... 7 



INTRODUCTION 21 

System Configuration .... 26 

The Supervisor /Generation Macros .... 29 

SUPVR 3 

CONFG 3 3 

STDJC 3 4 

FOPT 3 5 

PIOCS 43 

VSTAB 4 4 

ALLOC 4 6 

ALLCCR 4 7 

lOTAB 4 8 

DVCGEN 5 

ASSGN 52 

DPD 54 

SEND[n] 55 

Supervisor Real Storage Requirements . .67 

Computing the Size of a Supervisor ... 69 

Planning an Operational Pack 71 

Organization of a DOS/VS System Pack . . 71 

Allocating Library Sizes 74 

Creating System Files 76 

The Page Data Set 76 

Recorder File (SYSREC) 76 

I Hard-Copy File (Models 115 and 125 

Only) 77 

System Generation and Maintenance 

Procedures 78 

DOS/VS System Distributions 78 

General System Generation Procedures . .79 

Maintenance Procedures 8 3 

DOS/VS DISTRIBUTION PROGRAM JOE 

CONTROL CODING SPECIFICATIONS 85 

Processing the Distribution Tape .... 86 
Initializing the Disk ......... 86 

i Creating a Back-Up of and Restoring a 
Disk/Only, 2-Spindle, 3330 or 3340 
Disk Storage System Using the Fast 
Copy Disk Volume Utility 9 3 

DOS/VS DISTRIBUTION PROGRAM MESSAGES . . 95 

Supervisor Messages 95 

Job Control Messages 105 

Initialize Disk Messages 107 

Restore Messages 118 

IBM 2314 Direct-Access Storage 

Facility Example 123 

2314 Example: Results of System 

Generation 124 

I IBM 3330/3340 Disk Storage Example . . .133 

IOCS 14 8 

IPL S Buffer Load 153 

IPL 153 

I Buffer Load (3203 Printer) 154 



Buffer Load (3211 Printer) . 154 

I Buffer Load (5203 Printer) 155 

Jet Control 155 

linkage Editor 156 

Librarian 156 

CORGZ 156 

MAINT 157 

CSERV 157 

CSERV 157 

I FSERV 158 

RSERV 158 

SSERV 158 

Supervisor 158 

System Generation Macros 160 

MCAR/CCH 16 

Transients 161 

Attention Routines, Initiators, 

Terminators, and Dum.ps 166 

Standard System Dump 166 

Translating System Dump 166 

Attention Routines, Initiators, 

Teririnatcrs 167 

Checkpoint/Restart ........... 167 

Disk Error Recovery Procedures (DKE) . .167 
Display Operator Console Support . . . .168 

PRINTLOG (Print the Hard-Copy File) . .16 8 
Tape Error Recovery Procedures (TPE) . .168 
Problem Determination Aids . . . . . . .16 9 

FDAID 169 

DUMPGEN 16 9 

SDAID . .16 9 

LSERV 170 

SUPERVISOR NUCLEUS — 5745-SC-SUP . . . .171 



MODULE 2: GENERATING A VERSION OF 

POWER — 5745-SC-PWR 173 

Machine Requirements 177 

POWER with RJE 17 8 

Programming Requirements 181 

Storage Estimates for a Miniirum POWER 

Partition 181 

POWER Program Generation Parameters . .183 
Generating POWER without Remote Job 

Entry 193 

Generating POWER with Remote Job Entry 

(RJE) . .207 

Local Testing of POWER/RJE 225 

Total Size of the POWER Partition . . .226 
Link-Editing POWER for a Supervisor 

without Relocating Loader 227 

Start POWER 227 

POWER Phases and Macros 228 

POWER Library Space Requirements . . . .231 
Deleting POWER Phases and Macros . . . .231 



MODULE 3: INSTALLATION VERIFICATION 
PROCEDURE 23 3 

Introduction .235 

ABD - The ABEND Dump 24 2 

ASL 242 

CAP - Cataloged Procedures 247 

EMA - 1401/1440/1460 Emulator 260 

EMB - 1410/7010 Emulator 26 3 

E20 - System/360 Model 20 Emulator . . .265 

OLT - OLTEP 26 9 

PWR - POWER 26 9 

UTL - System Utilities 27 

MODULE 4: 1401/1440/1460 DOS/VS 

EMULATOR ON SYSTEM/370 — 5745-SC-EML . .271 



MODULE 5: 1410/7010 DOS/VS EMULATOR ON 
SYSTEM/370 ~5745-SC-EML . 275 



MODULE 14: IBM 3886 OPTICAL CHARACTER 
READER IOCS — 5745-SC-CCR 325 

MODULE 15: PAPER TAPE IOCS 

— 5745-SC-PTP 327 

MODULE 16: SEQUENTIAL DISK IOCS 

— 5745-SC-DSK. 329 

MODULE 17: VSAM ...» 333 

Core Image Library 334 

Relocatable Library 335 

Source Statement Library 337 

VSAM Storage Requirements 337 



MODULE 18: ASSEMBLER — 5745-SC-ASM . 



.339 



MODULE 6: EMULATING THE SYSTEM/3 60 
I MODEL 20 ON MODELS 115, 125, AND 135 

— 5745-SC-E20 279 

Model 20 Emulator under DOS/VS 28 

Data Interchange Function 281 

MODULE 7: COMPILER IOCS MODnT.ES 

— 5745-SC-IOM 283 

Relocatable Module Naming Conventions .28 5 

CDMOD 28 6 

DAMOD 28 9 

DIMOD 290 

ISMOD 290 

MTMOD 291 

PRMOD 29 3 

SDMOD 294 

Required IOCS Modules 296 

MODULE 8: DIRECT ACCESS — 5745-SC-DAM .297 



MODULE 9: 3540 DISKETTE I/O UNIT IOCS 

— 5745-SC-DIO 301 

MODULE 10: INDEXED SEQUENTIAL ACCESS 
METHOD — 5745-SC-ISM 305 

MODULE 11: MAGNETIC CHARACTER READER 

IOCS --5745-SC-MCR 311 

MODULE 12: MAGNETIC TAPE IOCS 

— 5745-SC-TAP 315 

MODULE 13: IBM 1287 OPTICAL CHARACTER 
READER IOCS — 5745-SC-OCR 321 



MODULE 19: OLTEP — 5745-SC-OLT 343 



MODULE 20: BTAM — 5745-SC-BTM 



MODULE 21: QTAM — 5745-SC-QTM 



.347 



361 



MODULE 22: SYSTEM UTILITIES 

— 5745-SC-UTL .379 

Assign Alternate Track Disk . . . . . .382 

Assign Alternate Track Data Cell . . . .382 

Clear Disk 383 

Clear Data Cell , -383 

Copy Disk to Card 383 

Copy Disk to Disk 384 

Copy Disk or Data Cell to Tape 384 

Copy and Restore Diskette ....... 384 

Deblock Utility 385 

Fast Copy Disk Volume 385 

Initialize Disk 386 

Initialize Data Cell 386 

Initialize Tape 386 

Restore Card to Disk 387 

Restore Tape to Disk or Data Cell . . .387 

VTOC Display 387 

Page Data Set Dump 388 

MODULE 23: EREP — 5745-SC-ERP 389 

GENERAL INDEX BY MODULE 3 93 



Module 1: Planning and Procedures 



Modular Outline 



INTRODUCTION 21 

Planning Summary 22 

Maps and Listings Produced during 

System Generation 24 

System Configuration 2 6 

Minimum Machine Requirements - Model 

115 26 

Minimum Machine Requirements - Model 

125 26 

Minimum Machine Requirements - Model 

135, 145, 155-11, or 158 27 

MNOTES during Supervisor Assembly . . 28 
Supervisor Select 2 8 

The Supervisor/Generation Macros .... 29 
Rules for Using Supervisor 
Generation Macros 2 9 

SUPVR 3 

Parameters for SUPVR 30 

CONFG 3 3 

Parameters for CONFG 33 

STDJC 3 4 

Parameters for STDJC .,....,... 34 

FOPT 3 5 

Parameters for FOPT 35 

PIOCS 4 3 

Parameters for PIOCS , . . 43 

VSTAB 4 4 

Parameters for VSTAB 44 

ALLOC 4 6 

Parameters for ALLOC .46 

System-Used Areas . 4 6 

ALLOCR 47 

Parameters for ALLOCR .47 

System-Used Areas 4 7 

lOTAB 4 8 

Parameters for lOTAB , 4 8 

DVCGEN 5 

Parameters for DVCGEN 5 

Rules for using DVCGEN 52 

ASSGN 5 2 

Parameters for ASSGN 53 

DPD 54 

Parameters for DPD 54 

SENDEn] 55 

Parameters for SEND 55 

Supervisor Real Storage Requirements . . 67 

Computing the Size of a Supervisor . . .69 

Planning an Operational Pack 71 

Storage Requirements for 

IBM-Supplied DOS/VS Prograrrs ..... 71 

Organization of a DOS/VS System Pack . . 71 

Allocating Library Sizes 74 

System Directory and Library Track 
Capacities 75 

Creating System Files 76 

The Page Data Set 76 



Recorder File (SYSREC) 76 

Creating and Using the Recorder File . 77 
Hard-Copy File (Models 115 and 125 

Only) 77 

System Generation and Maintenance 

Procedures 78 

DOS/VS System Distributions 78 

Systems without Tape 79 

IBM 2314-Only (and 2319-Only) Users 79 
IBM 3330-Only (and 3333-Cnly) Users 79 

IBM 3340-Only Users 79 

Tape Users 79 

General System, Generation Procedures . . 79 

Maintenance Procedures 83 

Replacing Identical Entries Using 

Merge Function 83 

Adding Unique Entries Using Merge 

Function 8 4 

General Library Updating 
Techniques Using the Merge 
Function of the CORGZ Librarian 

Program 84 

Copying Selectively to Merge 

Libraries 84 

Deleting Unwanted Entries and 
Merging an Entire Library with 

Another Library ..... 84 

Copying Selectively,, Merging Two 
Libraries to Create a Third Library . 84 
Deleting Unwanted Entries from Two 
Libraries and Merging Both Libraries 
to Create a Third Library 8 4 

DOS/VS DISTRIBUTION PROGRAM JOB 

CONTROL CODING SPECIFICATIONS 85 

Processing the Distribution Tape .... 86 

Initializing the Disk 86 

Bypassing the Initialize Disk 

Procedure 87 

Restoring the IBM-Supplied 

Distribution Tape to Disk 88 

Creating a Back-Up of your Generated 

System 8 9 

Copying a System Disk to Tape ... 90 
Restoring the Back-Up Tape to Disk . 91 
Creating a Back-Up of and Restoring a 
Disk/Only, 2-Spindle, 3330 or 3340 
Disk Storage System Using the Fast 
Copy Disk Volume Utility ........ 93 

DOS/VS DISTRIBUTION PROGRAM MESSAGES . . 95 

Supervisor Messages , 95 

Job Control Messages 105 

Initialize Disk Messages 107 

Restore Messages 118 

IBM 2314 Direct-Access Storage 

Facility Exam.ple -.123 



Module 1: Planning and Procedures 7 



Input/Output Device Configuration 

for 2314 Example (See Figure 1-14) . .124 
2314 Example: Results of System 
Generation 124 

JEM 2314/2319 Non-Tape Users 125 

IBM 2314/2319 and Tape Users 125 

IBM 3330/3340 Disk Storage Example . . .133 

Input/Output Device Configuration 

for 3330/3340 Example (Figure 1-16) .134 

IBM 3330 Only Users 135 

IBM 3340 Only Users 135 

IBM 3330/3340 and Tape Users . . . .135 
IOCS 14 8 

Source Statement Library 14 8 

File Definition Macros 14 8 

IOCS Macro Storage Requirements . .14 9 

CDMOD (Card Module) 150 

DIMOD (Device Independent System 

Units Modules) 15 2 

DTFDI (Define The File Device 

Independent System Units) 152 

PRMOD (Printer Module) 152 

DTFPR (Define The File Printer) . .152 
DTFPH (Define The Physical IOCS) . .153 
DTFCN (Define The File Console) . .153 
DTFSR (Define The File Serial 

Device) 153 

IPL S Buffer Load 153 

IPL .15 3 

Core Image Library 15 3 

Transients 153 

Phases . .15 3 

Relocatable Library 153 

Module 153 

Link-Edit Statements ....... .154 

Buffer Load (3203 Printer) 154 

Core Image Library 154 

Phases 154 

Relocatable Library 154 

Modules 154 

Link-Edit Statements . 154 

Buffer Load (3211 Printer) 154 

Core Image Library 154 

Modules 154 

Link-Edit Statements 154 

Buffer Load (5203 Printer) 155 

Core Image Library 155 

Phases 155 

Relocatable Library 155 

Modules 155 

Link-Edit Statements 155 

Job Control 155 

Transients 155 

Core Image Library 155 

Phases ." 155 

Relocatable Library 155 

Modules 155 

Link-Edit Statements 155 

Linkage Editor 156 

Core Image Library 156 

Phases 156 

Relocatable Library 156 

Modules '. . , . .156 

Link-Edit Statements 156 



Workfile Requirements for Linkage 

Editor 156 

Librarian 156 

CORGZ 156 

Core Image Library 156 

Phases 156 

Relocatable Library 157 

Modules 157 

Link-Edit Statements 157 

MAINT 157 

Core Image Library 157 

Phases 157 

Relocatable Library 157 

Modules 157 

Link-Edit Statements 157 

CSERV 157 

Core Image Library 157 

Phase 157 

Relocatable Library 157 

Module 157 

Link-Edit Statements 157 

DSERV 157 

Core Image Library 157 

Phases 157 

Relocatable Library 158 

Modules 158 

Link-Edit Statements 158 

PSERV 15 8 

Core Image Library .158 

Phase 158 

Relocatable Library ...,,, e = =158 

Module 15 8 

Link-Edit Statements 158 

RSERV . . . 15 8 

Core Imiage Library 158 

Phase 15 8 

Relocatable Library 158 

Modules 158 

Link-Edit Statements 158 

SSERV 158 

Core Image Library .15 8 

Phase 158 

Relocatable Library . 158 

Modules 158 

Link-Edit Statements 158 

Supervisor 158 

Core Image Library 158 

Phase 158 

Source Statement Library 159 

Supervisor Comimunicaticn Macros . .159 
Supervisor Generation Macros . . . .159 

System Generation Macros 160 

MCAR/CCH 160 

Core Image Library 160 

Transients 160 

Transients 161 

Device Error Routines and 
OPEN/CLOSE Phases for DOS/VS . . . .161 
Attention Routines, Initiators, 
Terminators, and Dumps ........ .166 

Standard System Dump 166 

Core Image Library 16 6 

Transients 166 

Relocatable Library 166 

Link-Edit Statements ....... .166 



8 DOS/VS System Generation 



Translating System Dump 166 

Core Image Library 166 

Transients 166 

Relocatable Library 167 

Link-Edit Statements 167 

Attention Routines, Initiators, 

Terminators 167 

Core Image Library ; .167 

Transients 167 

Checkpoint/Restart 167 

Core Image Library 167 

Transients 167 

Source Statement Library 167 

Macro 167 

Disk" Error Recovery Procedures (DKE) . .167 

Core Image Library 167 

Transients 167 

Source Statement Library 167 

Macro 16 7 

Display Operator Console Support . . . .168 

Core Image Library 16 8 

Transients 168 

Source Statement Library 16 8 

Macros 168 

PRINTLOG (Print the Hard-Copy File) . .16 8 

Core Image Library 16 8 

Phase 16 8 

Relocatable Library 16 8 

Module 168 

Link-Edit Statements 16 8 

Tape Error Recovery Procedures (TPE) . .168 

Core Image Library 16 8 

Transients 168 

Phase 168 



Relocatable Library 16 8 

Module 16 8 

Link-Edit Statements 16 8 

Problem Determination Aids 16 9 

PDAID 16 9 

Core Image Library 16 9 

Phases 169 

Transients . .169 

Relocatable Library 16 9 

Modules 169 

DUMPGEN 16 9 

Core Image Library 169 

Phase 16 9 

Relocatable Library 169 

Module 16 9 

Link-Edit Statements 16 9 

SDAID 169 

Core Image Library .169 

Phases 169 

Transients 16 9 

Relocatable Library 16 9 

Modules 16 9 

Link-Edit Statements 16 9 

LSERV 17 

Core Image Library 17 

Phase 170 

Relocatable Library 170 

Module 170 

Link-Edit Statements 170 

SUPERVISOR NUCLEUS — 57a5-SC-SUP . . . .171 

Configuration 171 

Core Iirage Library 171 

Phase 171 



Module 1: Planning and Procedures 9 



Modular Ind 



ex 



AB 35 

abnormal termination exit (AB) ... 35 
ACANCEL (supervisor generation 

parameter) 34 

adding unique entries using merge 

function 84 

ALIGN 34 

ALLOC macro 46 

ALLOCR macro 47 

allocate 46 

allocating library sizes 74 

alternate track assignment disk 

core image library 147 

modules, number of 147 

phases, number of 147 

alternate track assignment 
data cell 

core image library . 147 

modules, number of ; . 147 

phases, number of 147 

AP 30 

ASCII 30 

assembler 

core image library blocks .... 144 

modules, number of 144 

phases, number of 144 

relocatable library blocks .... 144 

ASSGN macro . . , 52 

attention routines ....... 144,167 

Attention Routines , Initiators , 
Terminators 
core image library blocks . . . .144 

transients 16 7 



B 

back-up tape, creation of 89 

back-up tape, restoring 91 

BGPGR 4 8 

BGR 47 

BLKMPX (supervisor generation 

parameter) 43 

Block Multiplex Channel Support ... 43 

BMPX 4 3 

BSCLNS 4 8 

BTAM 

core image library blocks-phases . 144 
core image library blocks-trans- 
ients 144 

library book (macro) , number of . 144 

modules, number of 144 

phases, number of 144 

source statement library blocks . 144 

BUFSIZE 45 

bypass initialize disk 87 



card to disk 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

CBF 35 

CCHAIN 42 

CDMOD . • 150 

CHAN 30 

CHANQ 48 

CHANSW 43,50 

CHARSET 34 

Checkpoint/Restart 16 7 

core image library blocks .... 144 

source statement library 144 

CHUN 50 

clear data cell 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

clear disk 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

command chaining (CCHAIN) 42 

conmion librarian modules 15 6 

computing the size of a supervisor . 69 

CONFG macro 33 

configuration, system 26 

console buffering (CBF) 35 

copy disk or data cell to tapfe 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

copy disk to card 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

copy disk to disk 

core image library blocks .... 147 

modules, number of 147 

phases, number of 147 

copying selectively to merge 

libraries ...... 84 

core image library 

components 144-147 

CORGZ 145,156 

CSERV . 145,157 

directory 75 

DSERV 145,157 

DUMPGEN . 146,169 

EREP ...144 

ESERV 14 4 

IBM-supplied 21 

IPL & Bufferload 145,153 

job control 145,155 

linkage editor 145,156 

MAINT 145,157 



Module 1: Planning and Procedures 11 



MCAR/CCH . . . . , . o , . . . 146,160 

PDAID 146,169 

PSERV 145 

RSERV 145,158 

SSERV 145,158 

standard system dump 144,166 

supervisor 146 

supervisor nucleus 146 

translating system dump . . . 144,166 
CORGZ 

core image library blocks .... 145 

link-edit statements ....... 157 

module names 157 

modules, number of 145 

phase names 156 

phases, number of 145 

creating a back-up of your 

generated system volume 89 

creating a third library from 

existing libraries 84 

creating system files 76 

Page Data Set 76 

Recorder file 77 

Hard-Copy file 7 7 

CSERV 

core image library blocks 145 

link-edit statements 157 

module names 15 7 

modules, number of 145 

phase names 15 7 

phases, number of 145 

CYL 54 

D 

D2311 48 

D2314 48 

D2321 48 

D3330 48 

D3340 48 

D2400 48 

D3410 48 

D3420 48 

D3540 48 

D3886 48 

DASDFP 36 

data cell to tape 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

DATE 34 

DEC 3 3 

DECK 34 

Define the Page Data Set (DPD) .... 54 

DELETECL 128,139 

DELETERL . 128,139 

DELETESL 128,139 

deleting entries and merging 

libraries 84 

device code - supervisor 5 7 

DIMOD 

storage requirements 152 

directory capacities, system 75 

DCC (Disconnect Command Chaining) ... 43 

DISK . 43 

disk to card 

core image library blocks 147 

modules, number of 147 



phages, number of 147 

disk to disk 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

disk ERP 16 7 

core image library blocks 144 

disk to tape ... 

core image library blocks 147 

modules, number. of 147 

phases, number of 147 

display operator console (DOC) .... 36 

distributed volumes 78 

distribution program 86 

distribution program messages .... 95 

DOC (display operator console) ... 168 

core image library blocks .... 144 

DOS/VS distribution program job 

control coding specifications . . 85 

DOS/VS system program sizes 144 

DPD macro 54 

DSERV 

core image library blocks .... 145 

link-edit statements 158 

module names 15 8 

modules, number of 145 

phase names 15 7 

phases, number of 145 

DTFCD (define the file card) , 

size of table 15*1 

DTFCN (define the file console) ... 153 

DTFDI (define the file device 

independent system units) 152 

DTFPK (define the file physical 

IOCS) , size of table 153 

DTFPR (define the file printer) , 

size of table 152 

DTFSR (define the file serial 

device) , size of table 153 

dumps 

standard system dump 166 

translating system dump 16 6 

DUMP 34 

DUMPGEN 

core image library blocks .... 146 

link-edit statements 169 

modules 169 

modules, number of 146 

phases 169 

phases, number of 146 

relocatable library blocks .... 146 

DVCGEN macro 50 

DVCTYP 50 

E 

ECPREAL (supervisor generation 

parameter) 36 

EDECK 34 

emulator ' 21 

end of supervisor (SEND) macro 

instruction 55 

environmental recording, editing, 
and printing program (see EREP) 
EREP 

core image library blocks .... 144 

modules, number of ....... 144 

phases, number of 144 



12 DOS/VS System Generation 



recorder file 77 

ERRLOG 30 

error recovery procedures 

disk (DKE) 167 

tape (TPE) 16 8 

error statistics 

by tape volume 41 

2495 Tape Cartridge Reader .... 41 

ERRQ 36 

ERRS 34 

ESERV . , 

core image library blocks 144 

modules, number of 144 

phases, number of 144 

relocatable library blocks 144 

EU 31 

EVA 37 

examples 

supervisor ..... 69 

system generation using 2314 .... 123 

system generation using 3330 or 3240. 133 

EXIT 42 

F 

Fast Copy Disk Volume utility 93 

FOPT macro 35 

FP 3 3 

FIPGR 49 

F2PGR 49 

F3PGR 49 

F4PGR 49 

F1,F2,F3,F4 46 

F4R,F3R,F2R,F1R 47 



general library updating tech- 
niques 84 

general system generation pro- 

dures 79 

generated system volume 

creating a back-up tape of 89 

restoring the back-up tape to disk . 91 

GETVIS 37 

GETVIS area in SVA 45 



H 

hard-copy file (model 115 or 125) ... 77 

I 

I/O configuration, SYSGEN ex- 
amples 124,134 

IBM-supplied 

core image library 21 

procedure library 22 

relocatable library 21 

source statement library 21 

IBM DOS/VS distribution 7 8 

IDRA 37 

initialize and restore programs 

bypass initialize disk 87 

initialize disk 86 

restore IBM tape to disk 88 



initialize data cell 

core image library blocks 147 

phases, number of 147 

initialize disk 

distribution program messages . . . 107 

core image library blocks 147 

phases , number of 147 

messages 107 

initialize tape 

core image library blocks 147 

phases, number of 147 

IOCS 

core image library blocks 148 

IOCS macros 148 

lODEV 49 

lOTAB macro 48 

IPL & buffer load (3203, 3211, and 
5203 printers) 

core image library blocks 145 

link-edit statements 154 

module names 15 3 

modules, number of 145 

phase names 15 3 

phases, number of 145 

IT 37 



JA 37 

JALIOCS 38 

JIB 49 

Job Accounting Interface 38 

job control 

core image library blocks 145 

link-edit statements 155 

module names 155 

modules, number of 145 

phase names 155 

phases, number of 145 

messages 105 



librarian programs ]56 

library sizes 74 

LINES 34 

linkage editor 

core image library blocks ..... 145 

link-edit statements 156 

module names 156 

modules, number of 145 

phase names . 156 

phases, number of 145 

LIST 34 

listings 24 

LISTX 34 

LOG 34 

LSERV 

core image library blocks 146 

link-edit statements 170 

module names 170 

modules, number of 146 

phase names 170 

phases, number of 146 

relocatable library blocks .... 146 



Module 1: Planning and Procedures 13 



M 

machine requirements, minimum .... 26 

macro instructions for generating 

a supervisor 29 

macros 

edited 131,142 

A-library • • • 131,142 

macros, IBM-supplied 

ALLOC 46,159 

ALLOCR 4 7,159 

ASSGN 52,159 

ASYSCOM 159 

ATTACH 159 

BDYBOX 159 

CALL 159 

CANCEL 159 

CCB 148 

CDLOAD 159 

CDMOD 150,148 

CHECK 148 

CHKPT 159,161 

CHNG 159 

CLOSE 14 8 

CLOSER 14 8 

CNTRL 148 

COMRG 159 

CONFG 33,159 

CRTAEX 16 8 

CRTAWT 16 8 

CRTGEN 16 8 

CRTIO 16 8 

CRTSAV 16 8 

DELETECL . 160 

DELETERL 160 

DELETESL 160 

DEQ 159 

DEQB 159 

DETACH 159 

DIMOD 152,148 

DOSCHLV 160 

DPD 54,159 

DTFBG 148 

DTFCD 151,148 

DTFCN 153,148 

DTFDI 152,148 

DTFEN 148 

DTFPH 153,148 

DTFPR 152,148 

tTFPT 148 

DTFSR 15 3,148 

DUMP 159 

DVCGEN 50,159 

ENQ 159 

ENQB 159 

EOJ 159 

ERET 14 8 

EXCP 14 8 

EXIT 159 

FCEPGOUT 159 

FEOV 148 

FEOVD 14 8 

FETCH 159 

FOPT 35,159 

FREE ....k 148 

FREEVIS 159 

GET 14 8 

GETIME 159 



GETVIS 159 

IJLQDSCT 159 

IJLQTSVC 159 

lOINTER 159 

lOTAB 4 8,159 

JDUMP 159 

LBRET 14 8 

LINKEDIT 160 

LOAD 159 

MAPCCB 159 

MAPCOMR . 159 

MAPERPIB . 159 

MAPLOWC 159 

MAPPIB 159 

MAPPUB2 159 

MAPRTFAB 159 

MORAS 159 

MVCOM 159 

NOTE . 148 

OPEN 14 8 

OPENR 14 8 

PAGEIN 159 

PDUMP 159 

PFIX 159 

PFREE 159 

PIOCS 43,159 

POINTR 148 

POINTS 148 

POINTW 148 

POST 159 

PRMOD 152,14 8 

PRTOV 148 

PUT 148 

PUTR ,,.==.... 168 

RCB 159 

READ 14 8 

REALAD 159 

RELEASE 148 

RELPAG 159 

RELSE 148 

RETURN 159 

RUNMODE 159 

SAVE 159 

SEND 55,159 

SEOV 14 8 

SETIME 159 

SETPFA 159 

SGAM 159 

SGCCWT 159 

SGDFCH 159 

SGDSK 159,167 

SGPMGR 159 

SGSVC 159 

SGTHAP 159 

SMICR 159 

STDJC 34,159 

STXIT 159 

SDPVR .30,159 

SYSCOM 159 

SYSIO 159 

TECB 159 

TRUNC 148 

VIRTAD 159 

VSTAB 4 4,159 

WAIT 159 

WAITF 148 

WAITM 159 

WRITE i 148 
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MAINT 

core image library blocks 145 

link-edit statements ....... 157 

module names 157 

modules, number of 145 

phase names 157 

phases, number of 145 

maintenance procedures 83 

maps 24 

MCAR/CCH 160 

core image library blocks 146 

MCH 31 

merge examples , conventions for 

MERGE function, use of 83 

messages, distribution program 

supervisor 95 

job control 105 

initialize disk 107 

restore 118 

MICR 31 

minimum machine requirements 26 

MNOTES during supervisor assembly . . 2 8 

MODE 51 

MODEL 33 

MRSLCH 44 

multitasking (AP) • 30 



N 

NPARTS 31 

O 

OC 38 

OLTEP 38 

core image library blocks 146 

modules, number of 146 

phases, number of 146 

relocatable library blocks .... 146 
operational pack 

organization . 71 

planning 22, 71 

operator-initiated communication (OC) 38 

organization of the system pack ... 7]_ 



VSTAB 44 

partition save areas 46,47 

PC 38 

PCIL 38 

PD 39 

PDAID 

core image library blocks 146 

phases 169 

phases, number of 146 

relocatable library blocks .... 146 

transients 169 

transients, number of 169 

PFIX 39 

PHO 32 

physical transient overlap 42 

PIOCS macro 43 

planning 

a version of POWER 21 

libraries (operational pack) . . 22,71 

supervisor 22 

system generation . 21 

the emulators 21 

the Page Data Set 21 

POWER (supervisor generation 

parameter) 32 

POWER 

core image library blocks 146 

source statement library blocks . . 146 
printer support, 3203/3211/5203 (see 
IPL & Buffer Load) 

PRINTLOG utility 16 8 

private libraries 81 

Private Second Level Directories ... 39 

PRMOD (printer module) . , 152 

problem determination, IBM sup- 
plied list for DOS/VS 22 

procedure library .......... 22 

processing the distribution tape ... 86 

PRTY 39 

PSERV 

core image library blocks 145 

link-edit statements 158 

module names 158 

modules, number of . 145 

phase names 158 

phases, number of 145 

PSLD (supervisor generation 

parameter) 39 

PTO 42 



Page Data Set, define the 76 

PAGEIN (supervisor generation 

parameter) 32 

page pool 47 

^parameters 

ALLOC 46 

ALLOCR 47 

ASSGN 53 

CONFG 33 

DPD 54 

DVCGEN 50 

FOPT 35 

lOTAB 48 

PIOCS 4 3 

SEND .■ 55 

STDJC 34 

SUPVR 30 



QTAM 

core image library blocks 

(transients) 

library book (macro) number of 

modules , ntomber of 

relocatable library blocks . . 
source statement library blocks 



RDE (ERRLOG) 

real address area, size of 



146 
146 
146 
146 
146 



30 
44 
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recorder file . 76 

reliability data extractor (RDE) ... 30 

RELLDR 39 

relocatable library, IBM-supplied . . 21 
relocatable library 

3203 printer bufferload 154 

3211 printer bufferload 154 

5203 printer bufferload 154 

common librarian modules 156 

CORGZ , 145,15 7 

CSERV 145,157 

DSERV 145,158 

ESERV 144 

DUMPGEN 146,169 

EREP 144 

IPL 145,153 

job control 145,155 

LSERV 146,170 

linkage editor 145,156 

MAINT 145,157 

PSERV 145,158 

RSERV 145,15 8 

SSERV . 145,158 

standard system dump 144,166 

translating system dump .... 144,167 
system utilities (see utilities) 

relocating load support 39 

replacing identical entries using 

merge function 8 3 

restore back-up tape to disk 91 

restore card to disk 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

restore system tape to disk 88 

restore tape to disk or data cell 

core image library blocks 14 7 

modules, number of 147 

phases, number of 147 

RETAIN 40 

RMS 32 

RMSR 31 

RSERV 

core image library blocks 145 

link-edit statements 158 

module names 158 

modules, number of 145 

phase names 158 

phases, number of 145 

RSIZE 44 

rules 

ASSGN 5 3 

DVCGEN 52 

supervisor generation macros ... 29 
RWTAU 4 3 



SDAID 

transient 169 

link-edit statements 169 

module names 169 

modules, niunber of 146 

phase names 169 

SDL (System Directory List) 23 



Second Level Directory 40 

SELCH 44 

SEND macro 55 

SETIME 37,42 

Shared Virtual Area (SVA) 44,45 

size of supervisors 69 

SKSEP 40 

SLD (supervisor generation 

parameter) 40 

source statement library 21 

source statement library macros 

components of 144-147 

supervisor generation 159 

supervisor communication 159 

system generation 29,55 

source statement library, IBM- 
supplied 21 

SPARM 35 

SSERV 

core image library blocks 145 

link-edit statements 158 

module names 158 

modules, number of 145 

phase names 15 8 

phases, number of 145 

SSLNS 50 

standard label option 83 

standard system dump 

core image library blocks 14 4 

link-edit statements 166 

module names 166 

modules, number of 144 

phase names ..,.==...... 166 

phases, number of 144 

STDJC 34 

Storage requirements for IBM-supplied 

DOS/VS programs 71 

STXIT 35,37,38,42 

supervisor select 28 

supervisor shipped by IBM ....... 171 

supervisor 

communication macro, books 159 

communication macro, names 159 

computing the size of 69 

core image library blocks 

(IBM-supplied) 146 

example for computing the size of . 69 

device code 57 

macro, generation, books 159 

macro, generation, names 159,29 

macros, source statement 

library 146 

messages 9 5 

phase name 158 

phases, number of 146 

real storage requirements 67 

SUPVR macro 30 

SVA (shared Virtual Area) 44,45 

SYM 35 

SYSFIL 40 

system configuration 26 

system directory and library track 

capacities 75 

System Directory List (SDL) 23 

system distribution 

disk only users 79 

tape users 78 
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system generation and maintenance 

procedure 78 

system program sizes, DOS/VS . . . 144,147 

system utility programs 

core image library blocks 147 

modules, number of 147 

phases, niomber of 147 

system libraries 

directory capacities 75 

track capacities 76 



table requirements 

DTFCD . 151 

DTFCN 153 

DTFDI 152 

DTFPH 15 3 

DTFPR 152 

DTFSR 153 

TAPE 44 

tape to data cell 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

tape to disk 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

tape ERP 16 8 

core image library blocks 146 

link-edit statements . 16 8 

module names 16 8 

modules, number of 146 

phase names 16 8 

phases, number of 146 

TEB (2495 error statistics) 46 

TEBV (tape error statistics 

by volume) 41 

teleprocessing 

(see BTAM and QTAM) 

time-of-day (TOD) clock support ... 41 

TOD 41 

TP 32 

transients, IBM-supplied 
$$A$SUP1 161 
$$ABERAA 161 
$$ABERAB 161 
$$ABERAC 161 
$$ABERAD 161 
$$ABERAE 161 
$$ABERAF 161 
$$ABERAG 161 
$$ABERAH 161 
$$ABERAI 161 
$$ABERAN 161 
$$ABERA1 161 
$$ABERA2 161 
$$ABERA3 161 
$$ABERA4 161 
$$ ABEKAS 161 
$$ABERA6 161 
$$ABERA7 161 
$$ABERP1 161 
$$ABERP2 161 
$$ABERP3 161 



$$ABERP4 


161 


$$ABERP5 


161 


$$ABERP6 


161 


$$ABERP7 


161 


$$ABERP8 


161 


$$ABERP9 


161 


$$ABERRA 


161 


$$ABERRB 


161 


$$ABERRC 


161 


$ $ABERRD 


161 


$ $ABERRE 


161 


$ $ABERRF 


161 


$ $ABERRG 


161 


$$ABERRH 


161 


$$ABERRI 


161 


$ $ABERRJ 


161 


$ $ABERRK 


161 


$ $ABERRL 


161 


$$ABERRM 


161 


$ $ABERRN 


161 


$ $ABERRO 


161 


$ $ABERRP 


161 


$ $ABERRQ 


161 


$ $ABERRS 


161 


$$ABERRT 


161 


$$ABERRU 


161 


$$ABERRV 


161 


$$ABERRW 


161 


$$ABERRY 


161 


$$ABERRZ 


161 


$$ABERZ1 


162 


$$ABERR1 


162 


$$ABERR2 


162 


$$ABERR3 


162 


$$ABERR4 


162 


$$ABERR5 


162 


$$ABERR7 


162 


$$BATTNA 


162 


$$BATTNB 


162 


$$BATTNC 


162 


$$BATTND 


162 


$$BATTNE 


162 


$$BATTNF 


162 


$$BATTNG 


16 2 


$$BATTNH 


162 


$$BATTNQ 


162 


$$BATTNR 


162 


$$BATTNS 


162 


$$BATTNT 


162 


$$BATTNU 


162 


$$BATTNV 


162 


$$BATTNW 


162 


$$BATTNX 


162 


$$BATTNY 


16 2 


$$BATTNZ 


162 


$$BATTN2 


162 


$$BATTN3 


162 


$$BATTN5 


162 


$$BCCPT1 


162 


$$BCE0V1 


162 


$$BCHKPD 


162 


$$BCHKPE 


162 


$$BCHKPF 


162 


$$BCHKPT 


162 


$$BCHKP2 


162 


$$BCHK3G 


162 


$$BCISOA 


162 


$$BCLOSE 


162 
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$$BCLOSP 


162 


$$BCL0S2 


162 


$$BCMT01 


162 


$$BCMT02 


162 


$$BCMT0 3 


162 


$$BCMT04 


162 


$$BCMT05 


162 


$$BCMT06 


162 


$$BCMT07 


162 


$$BDMPBC 


162 


$$BDMPDC 


162 


$$BDMPVA 


162 


$$BDRSTR 


162 


$$BDUMP 


162 


$$BDUMPB 


162 


$$BDUMPD 


162 


$$BENDFP 


162 


$$BENDFL 


162 


$$BEOJ 


162 


$$BE0J1 


163 


$$BE0J2 


163 


$$BE0J2A 


163 


$$BE0J3 


163 


$$BE0J3A 


163 


$$BE0J4 


163 


$$BE0J5 


163 


$$BE0J7 


163 


$$BERRTN 


163 


$$BFCB 


163 


$$BFCB3 


163 


$$BFCB5 


163 


$$BILSVC 


163 


$$BINDEX 


163 


$$BJCOPT 


163 


$$BJC0P1 


163 


$$BJDUMP 


163 


$$BLSTIO 


163 


$$BLVTOC 


163 


$$BMSGWR 


163 


$$BMVKEY 


163 


$$B0CPM1 


163 


$$B0CPM2 


163 


$$B0CPT1 


163 


$$B0CPT2 


163 


$$B0CPT3 


163 


$$B0CPT4 


163 


$$BOCP01 


163 


$$BOCP02 


163 


$$BOCP0 3 


163 


$$B0CP11 


163 


$$B0CP12 


163 


$$B0CRT1 


164 


$$B0CRT2 


164 


$$B0CRT3 


164 


$$B0CRT4 


164 


$$B0CRT5 


164 


$$B0CRT6 


164 


$$BOCRTA 


163 


$$BOCRTB 


163 


$$BOCRTC 


163 


$$BPCRTD 


163 


$$BOCRTE 


163 


$$BOCRTF 


163 


$$BOCRTG 


163 


$$BOCRTH 


163 


$$BOCRTK 


163 


$$BOCRTL 


163 



$$BOCRTM 


163 


$$BOCRTN 


163 


$$BOCRTO 


163 


$$BOCRTP 


163 


$$BOCRTQ 


163 


$$BOCRTR 


163 


$$BOCRTS 


163 


$$BOCRTT 


163 


$$BOCRTU 


163 


$$BOCRTV 


163 


$$BOCRTW 


163 


$$BOCRTX 


163 


$$BOCRTY 


163 


$$BOCRTZ 


163 


$$BODACL 


164 


$$BODAIN 


164 


$$B0DAI1 


164 


$$B0DA01 


164 


$$B0DA02 


164 


$$B0DA03 


164 


$$B0DA04 


164 


$$B0DAU1 


164 


$$BODI01 


164 


$$BODI02 


164 


$$BODI03 


164 


$$BODI04 


164 


$$BODI05 


164 


$$BODI06 


164 


$$BODI07 


164 


$$BODI0 8 


164 


$$BODMSG 


164 


$$B0DMS2 


164 


$$BODQUE 


16 4 


$$BODSMO 


164 


$$BODSMW 


164 


$$BODSPO 


164 


$$BODSPV 


164 


$$BODSPW 


164 


$$BODUCP 


164 


$$BOFLPT 


164 


$$BOIS01 


164 


$$BOIS02 


164 


$$BOIS03 


16 4 


$$BOIS04 


164 


$$BOIS05 


164 


$$BOIS06 


164 


$$BOIS07 


164 


$$BOIS08 


164 


$$BOIS09 


164 


$$BOIS10 


164 


$$BOMRCE 


164 


$$B0MSG1 


164 


$$B0MSG2 


164 


$$B0MSG3 


164 


$$B0MSG4 


164 


$$B0MSG5 


164 


$$B0MSG6 


165 


$$B0MSG7 


165 


$$BOMT0M 


165 


$$BOMT0W 


165 


$$BOMT01 


165 


$$BOMT02 


165 


$$BOMT0 3 


165 


$$BOMT04 


165 


$$BOMT05 


165 


$$BOMT06 


165 


$$BOMT0 7 


165 
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transients , 


IBM-supplied 


(cont . ) 


$$BONVOL 


165 




$$BOPEN 


165 




$$BOPENC 


165 




$$BOPEND 


165 




$$BOPENR 


165 




$$B0PEN1 


165 




$$B0PEN2 


165 




$$BOPIGN 


165 




$$BOPNLB 


165 




$$B0PNR2 


165 




$$B0PNR3 


165 




$$B0RTV1 


165 




$$B0RTV2 


165 




$$B0SDC1 


165 




$$B0SDC2 


165 




$$BOSDEV 


165 




$$B0SDI1 


165 




$$B0SDI2 


165 




$$B0SDI3 


165 




$$B0SDI4 


165 




$$B0SD01 


165 




$$B0SD02 


165 




$$B0SD03 


165 




$$B0SD04 


165 




$$B0SD05 


165 




$$B0SD06 


165 




$$B0SD07 


165 




$$B0SD08 


165 




$$B0SD09 


165 




$$B0SDW1 


165 




$$B0SDW2 


165 




$$B0SDW3 


165 




$$BOSD00 


165 




$$BOSD01 


165 




$$BOSIGN 


165 




$$BOUR01 


165 




$$BOVDMP 


165 




$$BOWDMP 


165 




$$B02321 


165 




$$BPCHK 


165 




$$BPDAID 


165 




$$BPDMPC 


166 




$$BPDUMP 


165 




$$BPSW 


166 




$$BRELSE 


166 




$$BRMSG1 


166 




$$BRMSG2 


166 




$$BRSTRB 


166 




$$BRSTRT 


166 




$$BRSTR2 


166 




$$BRSTR3 


166 




$$BRSTR4 


166 




$$BSDRUP 


166 




$$BSETFF 


166 




$$BSETFG 


166 




$$BSETFH 


166 




$$BSETFL 


166 




$$BSETL 


166 




$$BSETL1 


166 




$$BSYSWR 


166 




$$BTERM 


166 




$$BUCB 


166 




$$BUCB3 


166 




$$BUCB5 


166 




$$BUFLDR 


166 




$$BUFLD1 


166 




$$BUFLD2 


166 





$$B3540I 166 

$$B3540O 166 

$$B35400 166 

$$RASTOO 160 

$$RAST01 160 

$$RAST02 160 

$$RAST03 160 

$$RAST04 160 

$$RAST05 160 

$$RAST06 160 

$$RAST07 160 

$$RAST08 160 

$$RAST09 160 

$$RAST10 160 

$$RAST11 160 

$$RAST12 160 

$$RAST13 160 

transients, required 161-166 

translating system dump 

core image library blocks 144 

link-edit statements 16 7 

modules, number of 167 

phase names 167 

phases, number of . . 144 

TRKHLD 41 

TSWTCH , 43 

TTIMER 42 



U 



UNIT . 

utilities, system 

(see system utility programs) 



54 



virtual address area, 44 

virtual partition save areas ..... 46 

virtual storage access method (VSAM) . 42 

VSAM 42 

VSIZE 45 

VSTAB macro 44 

VOLID 5 4 

VTOC display 

core image library blocks 147 

modules, number of 147 

phases, number of 147 

transients, number of 147 

W 

WAITM 42 

X 

XREF 35 

Z 

ZONE 42 
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Introduction 



The object of D0S/7S systeir; generation is to tailor the IBM-supplied 
system to the requirements of your installation. This tailoring process 
is accomplished by: 

1. Planning system generation 

2. Implementing the plan by performing a system generation (the subject 
of this took) 

3. Testing the results by running the applicable Installation 
Verification Procedure (IVP) and/or sample problems. 

Detailed planning is essential to efficient system generation. It 
minimizes the need to modify the system after it is generated. You may 
want to contact your IBM marketing representative to set up a system 
generation planning meeting. IBM field engineering would also attend 
the meeting to discuss the procedure to install the SCP (systems control 
programming). Generating a system includes: 

• Tailoring the supervisor to the needs of your installation, which 
includes planning the options and estimating the size of the 
supervisor. This entails assessing the implications and effects of 
some of the major supervisor options, such as multiprogramming and 
POWER, on the operation of your system. 

• Planning the libraries, that is planning the contents, organization 
and size of the system and/or private libraries. 

• Generating a version of POWER (optional). 

• Planning the Page Data Set. 

• Emulator generation (optional) . 

These major planning considerations are described in detail in the 
DOS/VS System M anagement Guid e, GC 33- 5 371. 

IBM supplies DOS/VS on either magnetic tape or on disk. These 
distributions are discussed in "Disk Operating System Distributions" . 

DOS/VS is shipped in three libraries: 

The source statement library contains macro definitions in edited 
format. After the desired parameters have been chosen, the macros can 
be assembled. Any A-library macros carried over from previous releases 
must be edited before they can be used for assembly. 

The relocatable library contains IBM programs that have not been 
assigned addresses for execution and assembled macros from the source 
statement library. These assembled macros perform input and output 
procedures for IBM-supplied programs. They constitute Logical IOCS 
modules that can also be used by problem programs, whenever applicable. 

The core image library contains programs that are ready for 
execution. System control programs and system service programs are 
always shipped in the core image library. An assembler program is also 
provided for system generation and maintenance. The system control 
programs must always be part of the system. The librarian programs are 
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a key set to the system and should be carefully considered before ever 
removing them from the system. 

A fourth system library, the prpcedure library is supported. The 
procedure library is designed to contain frequently used sets of job 
control and linkage editor control statements, as well as control 
statements for IBM-supplied service programs. 

During system generation, you work with the IBM-supplied system, 
tailoring it to your individual needs by adding to and deleting from the 
IBM-supplied and your own private libraries (source statement, 
relocatable, and core image). Please note that the procedure library 
can only be a system library; the system does not support private 
procedure libraries. 

PLANNING SUMMARY 

The following considerations and decisions should be made before system 
generation: 

• Select supervisor options by coding a set of supervisor macro 
instructions (see . "Chapter 3: Planning the System" in DOS/VS System 
Management Guide, GC33-5371). 

• Determine the programs to be in the core image and relocatable 
libraries of each operational pack. 

• To utilize the serviceability aids recommended in DOS/VS 
iServiceability Aids and Debugging Procedures, GC 33-5380, during 
system generation, include applicable aids from the following list in 
your DOS/VS system (section numbers refer to sections in that 
manual) : 

a) Recovery Management Support (including Tape and Disk Error by 
Volume Statistics — Section 2-F) 

b.) Fetch/Load, I/O, GSVC and QTAM traces, and the Transient Dump 

(Problem Determination Serviceability Aids, PDAIDS — Section 2-E) 

c) DUMPGEN (DOS/VS Stand-alone DUMP Generator, with formatting DUMP 
option -- Section 2-A) 

d) LVTOC and the Library Display Program (including the Access Method 
Services Utility Aids — Section 2-C) 

e) Online Terminal Test (Teleprocessing Aids — Section 2-F) 

f) LSERV (Label Cylinder Display Program — Section 2-C) 



g) SDAIDS (System Debugging Aids — Section 2-B) 

If the system supports private core image libraries 
specified in the FOPT macro) determine which program 
placed in the private core image library or librarie 
system, the linkage editor executes in any partition 
link-edit most IBM-supplied programs for execution i 
partition and place them in a private core image lib 
that partition if enough core storage is available t 
link-edited program. If desired, the version to exe 
background partition may be retained in the system c 
library. It is not necessary to have different vers 
particular program, for execution in different parti 
supervisor is generated to include the relocating lo 
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You must place the supervisor, (default name $$A$SUP1) , in the systeir 
core image library. k supervisor cataloged to a private core image 
library cannot be used. If the requested phase is a $$R phase 
(MCAR/CCH transient) , the systeir only searches the system core image 
directory. If the requested phase is a $$A or $$B phase (transient), 
the system first searches the system core image directory, then, if 
necessary, the private core image directory assigned to the 
partition; if the phase is not found, the system enters the wait 
state with an error message of C4W (X'04E6') in bytes and 1 of low 
storage. 

When you request other phases, the system searches both the system 
and private directories, if necessary. If the phase name starts with 
$, the system first searches the syoterr, core image directory and, if 
it does not find the phase, it then searches the directory of the 
private core image library, assigned to the partition. If the 
requested phase name does not begin with a $, the order is private 
core image directory, then system core image directory, unless 
SYS=yES is specified in the FETCH or LOAD macro in which case the 
system directory is always searched first. 

To improve fetch/load performance in a multiprogramming system you 
can build a System Directory List (SDL), containing the names of and 
additional fetch/load information on frequently used transients and 
phases. The list is built as a result of the SET SDL=CREATE corrmand 
and subsequent data statements (please note that these statements can 
also be provided through a cataloged procedure) . The procedure 
library on the IBM distribution medium contains two such procedures, 
which are cataloged under the names of SDL and IKQVPSVA, 
respectively. Procedure SDL builds a system directory list for 
systems generated without VSAM support. Procedure IKGVPSVA builds a 
system directory list for items that include VSAM. Additions to or 
deletions from both these procedures can be made by using the PSERV 
program. The usage of this program is explained in the DQS/VS System 
Management ^Guide , GC33-53 71. 

Determine which modules are to be deleted from the relocatable 
library of each operational pack. Deleting frorr the relocatable 
library allows for expansion of the system, core image library to hold 
a greater number of components. Refer to the m.cdule for each 
component for its sizes. 

Also determine if the macro definitions used to build the supervisor 
and IOCS modules are to be deleted from the source statement library. 
Retaining the macros in the source statement library facilitates 
building a new supervisor and new IOCS modules. 

With one disk drive you m.ay prefer to maintain only enough room in 
the relocatable library of the operational pack to contain the 
modules for building the largest component in the system. This small 
relocatable library permits temporary insertion of any component in 
relocatable form. It can then be immediately link-edited into the 
system core image library and then deleted from the relocatable 
library. When the relocatable library is subsequently condensed, 
only the updated core image form of the component remains, thus 
conserving disk-storage capacity. Reducing the size of the 
relocatable library allows expansion of the system core image 
library. The expanded system core image library allows a greater 
number of components to be contained in a single systems volume. 

Copy and restore programs are necessary to transfer the resident 
system from tape to disk, from, disk to tape, from disk to cards, and 
from cards to disk for maintenance and backup purposes. 
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The procedures for the cc 
assume the system packs t 
199, when using a 2311/23 
For the 3340 the VTOC is 
3348/35MB and on cylinder 
assumed to be initialized 
a 2314/2319) or on cylind 
VTOC is assumed to be on 
on either cylinder or 6 



nfigurations shown in this publication 
o be initialized with the VTCC on cylinder 
19, or on cylinder 403 when using a 3330. 
assumed to be on cylinder 347 for the 
695 fcr the 3348/70MB. The work packs are 
with the VTOC on cylinder zero or 199 (for 
er or 403 (for a 3330). Fcr the 3340 the 
either cylinder or 347 for a 3348/35MB or 
95 for a 3348/70MB. 



MAPS AND LISTINGS PRODUCED DURING SYSTEM GENERATION 



All linkage editor output on SYSLST from the system generation procedure 
and any future updates (including maps produced by the linkage editor) 
must be retained. These maps provide necessary information on the level 
of the system and the load address (relocation) of each component, 
similarly, all assembly listings produced during system generation, in 
particular supervisor and POWER listings, should be retained. These 
maps and listings are used by the systems programmer and the customer 
engineer maintaining the system. 
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( Start Planning ^ /^ ^ 

Decide on the number 1 ( 2 1 

of svstem disks. ^J V^ J 



Supervisor 

1, Select options. 

2. Calculate real 
storage bytes. 

SEND address. 



ivate Core 
Image Library* 

1. Select programs 
to reside in 
this library 

2. Calculate 
library size. 



System Core 
Iniage Library 

1, Select programs 
to reside in Core 
Image Library. 

2. Calculate 
library size. 




Private Relocatable 
Library* 

1 . Select programs 
to reside in 
this library. 

2. Calculate 
library size. 



System Relocatable 
Library 

1. Select programs 
to reside in 
this library. 

2. Calculate 
library size. 
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Replan! 
The system you desire 
does not fit into the 
space available. 





Private Source 
State ment Lib rary 

1. Select books to 
reside in this 
library. 

2. Calculate 
library size. 



Sv5tem Source 
S^tatemmt Libr, 

1. Select books to 
reside in this 
library. 

2. Calculate 
library size. 





System procedure 
library 

1. Select procedures 
to reside in this 

Library 

2. Calculate 
library size. 



Estimate Workfiles 
ForTuPVRTssembly 
based on SUPVR 
size. 



6 



*During a search operation, private libraries are 
searched BEFORE system libraries, except when 
searching core inriage libraries for phase names 
beginning with $. 



Figure 1-1. INTRODUCTION — Planning Summary 
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System Configuration 

This section presents the irinimuni system configuration required to 
operate DOS/VS. The systeir contrcl prcgrairs and basic IOCS must always 
be present to execute any other programs. In view of the many different 
possibilities of attaching I/O units tc the CPU models supported, the 
minimum machine requirements for the Model 115 CPU and the Model 125 CPU 
are listed separately. The requirements for the CPU Models 135, 145, 
155-11, and 158 are listed together. 

MINIMUM MACHINE REQUIREMENTS - MODEL 115 

A System/370 CPU Model 115. 

Standard instruction set (See Note 1). 

One Card Reader: 1442**, 2501**, 2520**, 2540**, 2560*, 2596**, 3505**, 
3525**, or 5425*. 

One Card Punch : 1442**, 2520**, 2540**, 2560*, 2596**, 3525**, or 
5425* (See Note 2) . 

One Printer : 1403**, 1443**, 3203* (Model 1 or 2) , or 5203* (with 
or without UCS) (See Note 2) . 

One Model 125 Integrated Display Operator Console, optionally with a 
5213 Console Printer attached. 

One 3340* Model A2 Disk Storage. 

* These devices are natively attachable to the Model 115. 

** These devices must be attached to the Model 115 via a multiplexer 
channel. 

Notes : 

1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 3410-3411 series magnetic tape unit, or a disk 
extent may be substituted for this device. If a 7-track tape unit 
is used, the data conversion feature is required, except when the 
unit is substituted for a printer. 

MINIMUM MACHINE REQUIREMENTS - MODEL 125 

A System/370 CPU Model 125. 

Standard instruction set (See Note 1). 

One Card Reader: 1442, 2501, 2520, 2540, 2560*, 3504*, 3505, 3525*, or 
5425* (See Note 2). 

One Card Punch : 1442, 2520, 2540, 2560*, 3525*, or 5425* (See Note 2). 

One Printer : 1403**, 1443, or 3203* (Model 1 or 2) (See Note 2). 

* These devices are natively attached. Attachment of Card Reader/Punch 
devices is as follows, either 
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One 3504, or 

One 3504 and one 2560, or 

One 3504 and one 3525, or 

One 2560, or 

One 352 5, or 

One 3504 and one 5425, or 

One 542 5. 

** This device may either be natively attached, or be attached to a 
multiplexer channel. 

One Model 125 Integrated Display Operator Console, optionally with a 
5213 Console Printer attached. 

One 3333 Model 1 Disk Storage, natively attached (two disk storage 
drives) . 

Notes: 

1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 2400 or 3400 series magnetic tape unit, or a disk 
extent may be substituted for this device. If a 7-track tape unit 
is used, the data conversion feature is required, except when 
substituted for a printer. 



MINIMUM MACHINE REQUIREMENTS - MODEL 135, 145, 155-11, OR 158 

A System/370 CPU Model 135, 145, 155-11, or 158. 

Standard instruction set (See Note 1). 

One Card Reader: 1442, 2501, 2520, 2540, or 3505 (See Note 2). 

One Card Punch : 1442, 2520, 2540, or 3525 (See Note 2). 

One Printer : 1403,, 1443, or 3211 (See Note 2). 

One 3210/3215 Console Printer Keyboard, attached to the multiplexer 
channel. 

One 2314* Direct Access Storage Facility, or 

One 2319 Direct Access Storage Facility, natively attached or 

One 3333 Disk Storage, Model 1, attached either natively or through a 
3830-2 Storage Control Unit (See Note 3), or 

One 3330 Disk Storage, Model 1 or 2*, attached through a 3830-1 Storage 
Control Unit (See Note 3) , or 

One 3340 Disk Storage, Model A2, attached through: 

a) the Integrated File Adapter (IFA) on the System/370 Model 135, or 

b) the Integrated Storage Control (ISC) on the Systeir:/370 Model 14 5, 
or 

c) the 3830-2 Storage Control Unit on the System/370 Models 135 and 
145. 

h ♦The minimum DOS/VS configuration requires two DASD spindles, or one 
f DASD spindle and two magnetic tape drives. If the tape units are 
7-track, the data conversion feature is required. 
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Notes; 

1. Language translators may require extended instruction sets. 

2. One 7- or 9-track 2400 or 3400 series iragnetic tape unit, or a disk 
extent may be substituted for this device. If a 7-track tape unit 
is used, the data conversion feature is required, except when 
substituted for a printer. Neither the tape unit nor the disk 
extent can be substituted for the card reader as the communication 
device during system IPL time. 

3. The 3333 Disk Storage (unless natively attached) and the 3330 Disk 
Storage, Model 1 or 2, require a high-speed selector channel. 

4. Attaches to the integrated file adapter (IFA) on the Model 135, to 
the integrated storage control (ISC) on the Model 145, or to the 
3830-2 storage control unit on Models 135 and 145. 

MNOTES DURING SUPERVISOR ASSEMBLY 

During supervisor assembly, the assembler may generate one or more 
MNOTES. You may choose to ignore some by accepting the assumed values 
given in the MNOTEs. For others, you may have to interrupt procedures, 
modify one or more specifications in a macro or macros, and reassemble 
the supervisor. 

Some gen er al procedures for resolving MNOTEs are: 

1. Go to the DIAGNOSTICS section at the end of the supervisor assembly 
listing; it includes references to the MNOTEs generated during 
assembly. Each MNOTE reference is in the form 

statement-number IPK216 MNOTE GENERATED 

2. Using the statement number, go back into the listing and examine 
each of the MNOTEs. A severity code precedes the m.essage portion 
(the higher the code, the rrore severe the error). Each MNOTE is 
listed after the macro with which it is associated. 

3. Determine the reason for the MNOTE. The MNOTE m.essage indicates the 
parameter in question and usually provides, a clue to the type of 
discrepancy. Some errors tc Icok for are: 

• Misspelled items or mispunched numbers. 

• Parameters that are incompatible with other parameters in this or 
another macro. 

• Parameter d that are outside the valid limits. 

4. Make any necessary changes and reassemble. If you have no changes 
to make (in other words, the assumed values listed in the MNOTEs are 
acceptable), continue with the generation procedures. Some errors 
are so severe, however, that nc object deck is generated, and you 
must correct one or more macros and reassemble before continuing. 

PUPEkVISOR SELECT 

The Supervisor Select function enables you to select different tailored 
supervisors, cataloged in the core image library of your operational 
pack. Cataloging these supervisors can be accomplished by changing the 
PHASE cari punched during supervisor assemblies. It is recommended to 
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naiTie the most frequently use(3 supervisor $$A$SUP1, since it is the 
default of the Supervisor Select function. 

The desired supervisor is selected at IPL time in one of the following 
ways: 

1. Depress the LOAD key on the CPU control panel; when the system 
enters the wait state depress the ext^rndi interrupt key; the 
default supervisor $$a$sup1 will then be selected. 

2. Depress the LO?\D key on the CPU control panel; when the system 
enters the wait state, depress the REQUEST key on the keyboard 

console typewriLei. Messaq--, 0103'^. ;::P!''r'I^''v c'UpfpVTSCP NAME is 
displayed. Type iri the naire cf the de^^irf"-'^ supervisor or depress 
the e:'JD or ENTER Key tc select the default $$A$fUiPl. 

3. You can also select the desired supervisor by using the card reader 
(see chapter "DOS/VS Distribution Program Messages"). 

Exam pl e : 

Change the PHASE card. 
PHASE $$A$SUPC,+0,NOAUTG 

Catalog the supervisor. When performing the IPL procedure, specify 

$$A$SUPC. 



The Supervisor /Generation Macros 



This section defines the thirteen iracro instructions and their 
parameters required to generate an installation-tailored supervisor for 
DOS/VS. 



RULES FOR USING SUPERVISOR GENERATION MACROS 

1. The assumed value default for an emitted paraireter is underlined in 
the following discussion. Wherever an alternate default is 
possible, both operands are underlined. Figure 1-U shows the 
device type codes of the DOS/VS supported devices used for system 
generation. 

2. Braces {} indicate that ycu must select one of the enclosed values. 

3. Bracketed operands are optional, for exam.ple, [n] . 

U. Replace the letter n in a parameter with a decimal nximber. 

5. The name field must be blank. The operation field always contains 
the mnemonic operation code. The operand field contains the 
parameters. 

6. For any given macro, several parameters may be contained on one 
line. Separate each parameter with a comma. No entedded blanks 
are permitted. Continuation cards are permitted (ncnblank 
character in column 72; the continue colum.n is column 16). 

7. In the expression X'cuu', replace cuu with the hexadecimal number 
for channel and unit. 
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8. The macros must be issued in the following sequence: SUPVR, CONFG, 
STDJC, FOPT, PIOCS, VSTAB, ALLOC, ALLOCR, lOTAB, DVCGEN , ASSGN, 
DPD, SEND. 

9. The DVCGEN, ASSGN, ALLOC, ALLOCR, and DPD rracros are not required. 
They are specified if input/output tables (DVCGEN) are being 
specified, if standard assignrrents (ASSGN) are being made if 
storage is allocated (ALLOC and ALLOCR) , cr if the page data set is 
defined at system generation time. 

10. An END card and a /* card rrust follow the SEND rracrc instruction. 



SUPVR 



The Supervisor (SUPVR) macro instruction and its pararreters define the 
system as disk resident with the ability to support certain desired 
functions, such as raultiprograrrrring, MLCR, or teleprocessing. 



PARAMETERS FOR SUPVR 



NO 
AP= (YES 



NO 
ASCII=(YES 



Specify if multitasking support is desired. 
Multitasking allows the execution of more than one program 
within a partition. Specification of AP=YES is required 
if you want to use the ATTACH, DETACH, ENQ, and EEQ iracrcs 
in your programs. WAITM=YES is forced by AP=YES. An 
invalid specification of AP causes YES to be forced. If 
AP=YES is specified and NPARTS is omitted or specified as 
1, NPARTS=3 is forced. 



Specify if supervisor support of ASCII/EBCDIC translation 
tables is desired. ASCII=YES iru_st be specified if support 
of ASCII tapes by magnetic tape IOCS is required. 

NO 

CHAN=lYES 
(Models 115 and 

125 only) This is an option for System/370 CPU Models 115 and 125 
only. Do not specify this parameter for CPU Models 135 
and upward. For these models, RMS error recording support 
is standard and specification of CHAN=YES will merely 
result in the generation of an MNCTE. If the MODEL 
parameter of the CONFG macro specifies 115 or 125, 
specification of CHAN=YES causes RMS error recording 
support to be generated, A specification of CHAN=YES is 
required if multiplexer channel-attached devices, tape 
units, or teleprocessing devices are present on ycur Model 
115 or 125 CPU. Software recording is performed for 
channel-attached devices and for tape units cnly. If 
these devices are part of the system, a check is made at 
IPL time to see if RMS error recording support is 
provided; if it is not, the system enters a hard wait 
state. RMS=YES overrides a specification of CHAN. 

ERRLOG=)RDe( Specify to include Reliability Data Extractor (REE) 

YES ) recording in addition to ncrmial RMS error recording. RDE 
causes recording of "End of Day" via the ROD operator 
command and of the cause of Initial Program Load (IPL) . 
This provides additional data for installation and IBM 
evaluation of system performance. The RDE option does net 
require any additional real storage. 
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If RDE recording is desired for a Model 115 or 125 CPU, 
normal RMS error recording support roust be generated by 
specifying CHAN=YES or RMS=YES. 



Note: For reasons of coropatibility with earlier DOS 
releases, ERRLOG=(YES,RDE) may still be specified. 
Specification of ERRLOG=YES has no effect since error 
recording is controlled by the MODEL= parameter or, for a 
Model 115 or 125, by CHAN= and RMS=. Specifying 
ERRLOG=(YES,RDE) is identical to specifying ERRLOG=RDE. 



NO 
EU=(YES 



TD 



Specify EU=YES if you require irixed parity tape processing 
for the 14xx emulators and the tape preprocessor and tape 
postprocessor programs. EU=YES need not be specified to 
run these programs if mixed parity tape processing is net 
required. 

Note: For reasons of compatibility with earlier DOS 
releases, specification of EU=RELOC is accepted by the 
assembler as if EU=YES had been specified. 



YES 
MCH= ( NO 
(Models 115 or 

125 only) This is an option for CPU Models 115 and 125 only. Do not 
specify this parameter for CPU Models 135 and upward. For 
these models, support of the Machine Check Analysis 
Recorder and Channel Check Handler features is standard. 
If the MODEL parameter of the CONFG macro specifies 115 or 
125, the default is YES if NPARTS>1; the default is NO if 
NPARTS=1. RMS=YES overrides a specification of MCH. 

I NO] Specify if the supervisor is to support magnetic ink 
1419 [ character readers or optical reader/sorters. If 
1419d) 1255/1259/1270/1275S are to be supported, indicate 1419. 

1419D indicates Dual Address Adapter lU19/1275s only; 1419 
support does not provide 1419D support. If 1419s or 
1255/1270/1275S are attached to a multiplexer channel, the 
PIOCS parameter EPMX=YES is supported. However, burst 
mode and MICR devices cannot run concurrently en the same 
byte-miultiplexer channel. A warning MNOTE to that effect 
is issued. 



NPARTS= 



Specify the nuirber of partitions to be supported. The 
rriaximuir value of n is 5. For reasons of compatibility 



with earlier DOS reledses, 
accepted by the asseirbler. 

The default taken is 1 if: 



NO, or I:JF is also 



The AP, MPS, POWER, and TP paraireters are either not 

specified, or specified as NO. 

The default take n i s 3 if any of the following is 
specified : 



AP=YES 
MPS=YES 
POWER=YES 
TP=QTAM 

If NPARTS is omitted or is specified as 1, specification 
of any of these paraireters forces ^;PARTS = 3. 
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NO 

PAGEIN=|n 



NO 

PHO=|YES 



NO 

POWER=|YES 



NO 
RMS=( YES 
(Models 115 and 
125 only) 



TP= 



NO 

BTAM 

QTAM 

QTAMn 



Specify that paging activity is to be controlled by the 
PAGEIN, RELPAG, and FCEPGOUT macros. These macros allow 
the programmer to 

• request the advanced page-in of one or more pages 
(PAGEIN macro) , 

• release the, contents of one or more pages (RELPAG 
macro) , and 

• request that one or more pages be given highest 
priority for page-out (FCEPGOUT macro) . 

(See DQg/VS Supervisor and I/O Macros, GC33-5373, for a 
complete description of these macros.) 

The value n indicates the rraxiirurr nuir.ber of page-in 
requests that can be queued at any one time for execution. 
Each PAGEIN macro issued in a program represents a page-in 
request. To obtain support for the three rriacros, the 
values specified for n must fce 1 or larger. 

Specify if page exception handling overlap (PHG) is 

desired. PHO=YES allows control to be passed to a user 
routine while a page fault is being handled. 

Specification of PHO=YES is required if you want to use 
the SETPFA macro in your programs. (For more details see 

the DCS /ys_S;i^stem_Mana3 erne nt_Guide, GC33-5371.) When 
PHO=YES is specified, PFIX=YES is forced. 

Specify if support for POWER is desired. If YES 

is specified, NPARTS=2, 3, U, or 5 must be specified. If 

NPARTS is omitted or if NPARTS=1 is specified, a 

specification of POWER=YES causes NPARTS=3 to be 

generated. 



This is an option for System/370 CPU Models 115 and 125 
only. Do not specify this parameter for CPU Models 135 
and upward. For these models. Recovery Management Support 
(RMS) is standard and a specification of RMS will merely 
result in the generation of an MNpTE, Specifying RMS=YES 
is equivalent to specifying both CHAN=YES and MCH=YES. 
RMS=YES overrides any specification of CHAN and/or MCH. 
If RMS=NO is specified, or if the parameter is omitted, 
the generation of RMS support is governed by specifying 
the CHAN and/or MCH parameters. 

Specify if teleprocessing support is desired and, if so, 
whether Basic (BTAM) , or Queued (QTAM) Access Method is 
desired. When QTAM is specified, support for ETAM is also 
included. If BTAM runs in virtual mode, PFIX=YES is 
required. For QTAMn, n is the maximum number of QTAM 
message processing programs in the system at any one time. 
n may have any value from 2 to 12, (For multitasking, 
AP=YE£ must be specified.) If AP=NO and QTAMn are 
specified, n is forced to 2. If TP=QTAM and NFARTS=1 or 
is omitted, NPARTS=3 is forced. 
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CONFG 

The configuration (CONFG) iracrc instruction and its paraireters define 
the system configuration and can specify generation of optional 
supervisor services. 

PARAMETERS FOR CONFG 



NO 
FP= (YES 



Specify only if your CPU has the floating-point 
feature. 



MODEL= 



115 

125 

135 

145 

155-11 

158 



Specify the CPU Model nuirter. Omission of this 
pararceter or an invalid specification causes 
supervisor generation to te terminated. If 
M0DEL=115 or 125, the generation of Recovery 
Management Support (MCAR/CCH and/or RMS error 
recording) is dependent en the specification of 
the RMS, CHAN, and MCH parameters of the SUPVR 
macro. For all ether CPU models, RMS-support is 
standard. 

Specify: 

M0DEL=115 for the IBM Model 3115 CPU 
MODEL=125 for the IBM Model 3125 CPU 
MODEL=135 for the IBM Model 3135 CPU 
M0DEL=m5 for the IBM Model 3145 CPU 
MODEL=155-II for the IBM Model 3155 CPU, Model II 
MODEL=158 for the IBM Model 3158 CPU 

Notes; 

1. For reasons of compatibility with earlier DOS 
releases, specification of MCDEL=155 is 
accepted by the assembler. Support for the 
Model 155-11 CPU is generated. 

2. When MODEL=125 is specified, support for the 
Display Operator Console and 3330 disk is 
always generated. When M0DEL=115 is 
specified, support for the Display Operator 
Console and 3340 disk is always generated. 

3. The storage protection and decimal features 
have been made standard. The Interval Timer 
is a standard System/370 hardware feature. 

If, however, you specify SP=, cr DEC= (whether 
the operand is YES or NO), the assembler will 
accept ycur specification and merely react by 
generating an MNOTE, which need not be 
resolved. TIMER =YES is also acceptable but 
generates no code. 

4. If you plan to run ycur generated system on 
more than one CPU model, you should specify 
the larger model nuititer. 
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STDJC 



The Standard Job Control (STDJC) iracro instruction and its pararreters 

specify the standard settings for job control. If the assumed opticns 
are all satisfactory, the only entry required is the STDJC macro 
instruction itself, without any parameters. These standard ^options 
except _LINES and DATE can be temporarily overridden by an OPTION 
statement, LINE S can_be overridden by a SET corrm.and, DATE by a// DATE 
statement. 



PARAMETERS FOR STDJC 



ALIGN= 



ACANCEL= 



CHARSET= 



DATE= 



DECK= 



YES 
NO 



NO 
YES 



48C 



Specify if the assembler is to align data on 
half word or fullword boundaries, according tc the 
type of instruction used. 



Specify if Job Control is to cancel jobs 
automatically (ACANCEL=YES) or to wait for 
operator intervention (ACANCEL=NC) after an 
unsuccessful attempt to assign a device. 



60C) Specify either the 4 8- or 60-character set for 
PL/I translator input on SYSIPT. 

MDYJ 

DMY) Specify the format of the date MDY=raonth/day/year , 
DMY=day/ir cnth/year . 



Specify if language translators are to produce 
object modules on SYSPCH. 



YES 
DUMP= 1 NO) Specify if a dump of the registers and virtual 

storage is tc be written on SYSLST in case of an 
abnormal program end. 

NO I Specify if the assembler is to create and punch 
EDECK=(YES) edited macros on SYSPCH. 

I YES I Specify if compilers are to summarize all errors 
NO 1 in source programs on SYSLST. Assembler and PL/I 
' always assume ERRS=YES. 



56 
LINES=Jnn 



YES 
LIST=) NO 



NO 
LISTX= YES 



Specify the number of lines per page on SYSLST. 
The minimum is 3 0; the maximum is 99. 



Specify if language translators are to write 
source module listings and diagnostics on SYSLST. 



Specify if compilers are to write hexadecimal 
object module listings on SYSLST. 



I YES 

LOG=) NO J Specify for a listing of all control statements on 

SYSLST. LOG=NO suppresses the listing of all job 

control statements on SYSLST. Invalid statements 
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and corrirands will be listed on SYSIST if it is 
assigned. 

i NO) 
SPARM= (YES I Specxfy if the &SYSPARM assembler system variable 
syitibcl is tc be supported. 

i —I 

SYM=\YES f SY!yi=YES iray be specified if the PL/I compiler is 

to produce a symbol and offset table listing on 
SYSLST, or if American National Standard COBOL is 
to produce a data division glossary. 

(YES ) 
XREF=\ NO (Specify if the assembler is to write symbolic 

cross-reference lists on SYSLST, or if American 
National Standard COBOL is tc produce a 
cross-reference listing. 

FOPT 

The Optional Features (FOPT) nnacrc and its pararreters specify additional 
optional features that can be included in the supervisor. 

PARAMETERS_FCR_FOPT 

( NO ) Specify if the abnormal termination exit function 
AB=(YES /is tc be supported. The abnormal termination 

exit, invoked via the STXIT AB macro, allows you 
to exit to a user's routine before an abnormal 
end-cf-job causes a prograir to be canceled. 
Specify YFS for American National Standard COBOL 
I/O error recovery. Ar: = YEt^ is fcrced if VSAK- = YES 
is specified in tne SUPVR macro. 

/no) Specify the ruirber of I/C requests for the 
CEF=\ n f operator console tc i::e cuffered. Under the 

follcwina conditions operator console I/O requests 
will net be cuffered: 

1. The actual record tc be written does not 

exceed ^ vj cnaracters. 

2. Data or command chaining is not perfcrrred. 

3. The CCB associated with this operation does 
net indicate the acceptance of unrecoverable 
I/C errcrs, posting at device end, or user 
error routines. 

4. The CCE does not request sense infcrmaticn. 

Console buffering 6.n(-?£ not apply tc Model 115 or 
125 Eisplay Operator Console support. CBF=n is 
ignored if MCDEL=115 cr 125 or DOC=125D is 
specified. 

Conscle buffering allows overlap cf CPU processira 
with write operations tc £:YCL0G ty satisfvirn the 
re.] u^ oti;r * s VvAIT irrir ediat c ly , rather than a+: I/o 
comyleticn tirre. When ti:is option is select-d. 
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Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 



the nuaber cf CHANQ entries should exceed the 
number of CliF entries so that the buffering 
process is net bcund by the nurrber of CHANQ 
entries. If the assurred option is taken for CHANQ 
and CEF is selected, the nuirber cf CHANQ entries 
is assumed to be six more than the CBF entry. 
Numbers 1 through 50 are valid, and one is assumed 
if the operand is invalid. 



NO 
DASDFP=\(ni,n2 



,2311' 
,2314 
,3330 
,3340 



jspecify if supervisory DASD file protection is 
desired where ni,n2 indicates the range of 
channels to vihich DASDs may be attached. File 
protection for the 2311, 2314, 2319, 3330, and 
3340 is default. File protection for the 2321 
must be specified and provides protection for all 
DASD devices. DASDFP prevents writing outside the 
extents of a file in case of program error. 
Extents are protected to the nearest cylinder 
except for 2321, where they are protected to the 
nearest head bank. This feature dees not protect 
the file from being overwritten. 



Notes : 

1. No file protection is provided for the TPM 
3540 Diskette Input/Cutput Unit. 

2. The lOTAE parameter JIB=n allocates storage 
for DASDFP extents. 

3. If a disk device type is specified by the 
third operand and this disagrees with the one 
as specified by the DISK parameter of the 
FICCS macro, the value cf this parameter will 
overrule the one specified by the third 
operand. 



i NO ) Specify if super 
DCC= (125D f Operator Console 
taken is depende 
specified by the 
macro. If MODEL 
125D is forced, 
parameter specif 
the Model 115 or 
Console support 
3210/3215 consol 
generated. This 
both Model 115 a 



visor support for the Display 

is to be generated. The default 
nt on the CPU model number as 

MODEL parameter of the CONFG 
=115 or iy;CDEL=125 is specified. 

The default is NO if the MODEL 
ies a System/370 CPU other than 

125. When Display Operator 
is generated, support for 
e printer keyboards is also 

allows your supervisor to run on 
nd larger model numibers. 



i NO ) Specification of this parameter allows use of the 
ECPREAL=\yes J VIRTAD macro, the REALAD macro, and of the EXCP 
macro with the REAL parameter. For good 
performance of the SORT/VS program, this option 
(ECPREAL=YES) should be specified. ECPREAL=YES 
forces PFIX=YES. 



5 I This paraireter is cpticnal. It is intended 
ERRQ=j 3 I prin,arily for teleprocessing systerrs with a large 

n) number of ccmnunication lines or devices. It 
specifies the nuirber cf entries tc be generated 
for the error queue. The default and miniirurr 
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number is 5 if the systeir is generated to support 
irultiprograiTiring . The default and ir.inimuir: nuirfcer 
is 3 if multiprogramiring is not supported. The 
iraxiiruir value of n is 25. 

NO j 
EVA= )(r,w) I Magnetic tape error volurre analysis is supported 
' (may be used with or without TEBV) . When the 
number of temporary read errors that occurred 
exceeds the value of r, the operator is notified 
via a message on SYSLOG. The maxim.um value for r 
cannot exceed 254, EVA=Cr,w) forces TAPE=7. 

When the number of temporary write errors that 
occurred exceeds the value of w, the operator is 
notified via a message on SYSLOG. The maximum 
value for w cannot exceed 254. 

After the operator message the system resets the 
temporary error count to zero and continues normal 
processing. 

NO ( Specify YES if storage management support 
GETVIS=|YEs( using the GETVIS and FREEVIS macrc instructions is 
desired. GETVIS=YES is forced if VSAM=YES is 
specified in the SUPVR macro. GETVIS=YES forces 
RELLDR=YES. 

No( Specify IDRA=YES if the Independent Directory 
IDRA=^YEs( Read-in Area (IDRA) is desired. IDRA=YES allows 
the system to read the directory containing the 
location of the phase specified in a FETCH or LOAD 
into the IDRA instead of using the System Error 
Recovery Procedure transient area. Thus, with the 
IDRA feature, throughput may increase when an 
error recovery procedure is in progress. IDSA=YES 
is valid only if the NPARTS parameter in the SUPVR 
iracrc specifies more than one partition. 

I Noj 
IT=|yesJ Specify if the interval timer can fce handled by 

probleir programs. IT=YES generates timer support 
for all tasks in al l partitions. It allows use of 
the STXIT IT and SETIME macros. 



Note; For reasons of compatibility with earlier 
DOS releases, specif icaticn of IT=EG, Fl, or F2 is 
accepted by the assembler. Timer support for all 
tasks in all partitions is generated as if IT-YES 
had been specified. 



NO 
JA=) YES 

(ni,na,n3,n/+ /ns)) Specify if Job Control Job Accounting Interface is 
to be supported. 

JA=YES indicates support for each partition. 

JA= {ni,n2f n3,n4 /Hs) specifies additional support 
of SIO count for I/O devices, and JA=YES is 
generated. The values substituted for n^., na, ng. 
Tilt, and ns indicate the number of I/O devices per 
k partition for which SIOs are to be counted. The 

I maximum value for n for any partition is 255; n^. 
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always specifies the number for the background 
partition. 

The partitions to which na through n^ refer depend 
on the number of partitions in the system, as is 
shown below: 



na 



na 



2 partitions 


Fl 






3 partitions 


F2 


Fl 




U partitions 


F3 


F2 


Fl 


5 partitions 


F4 


F3 


F2 



Fl 



If no SIO count is required for a given partition, 
no value should be supplied. However, the operand 
delimiter (comma) must be submitted if other 
values follow. 



JALIOCS= 



NO 
(s,l) 



NO 

0C=| YES 



YES 

OLTEP=} NO 



NO 
PC=IYES 



For example, if NPARTS=5 and JA=(10,,3) are 
specified, SIO count is supported for: 

10 1/0 devices for the background partition 
I/O devices for the F4 partition 
3 I/O devices for the F3 partition 
I/O devices for the F2 partition 
I/O devices for the Fl partition 

Specify for support of user-written job accounting 

routines containing LIOCS, and LIOCS with label 

processing. If you specify JALIOCS=(s ,1) , JA=YES 

or in^gnzinseTil^e'nS} rrust be specified as well. 

s and 1 reserve a user save area and a label area 
equal to their specifications (i.e., if s equals 
25, then a 25-byte save area is reserved) . s can 
be any decimal number in the range - 1024. If s 
is omitted, or if JALIOCS=NO, a 16 byte user save 
area is still reserved in the supervisor if JA*NO 
is specified. 1 can be any decimal number between 
and 22U. 



Specify if operator-initiated coirirunication is tc 
be handled by prcbleit: programs. Allows use of the 
STXIT CC iracro. If YES is specified, the facility 
is available to all partitions generated. YES is 
required if errulator program operator services are 
to be requested through the interrupt key. If 
RETAIN=YES or OLTEP=YES is Specified, OC=YES is 
forced. 

Specify OLTEF=YES if the online testing function 
is desired. OLTEP=YES allows the online test 
executive prograrr to execute. If CLTEP=YES, then 
RELLDR=YES and OC=YES are forced. Specification 
of RETAIN=YES forces OLTEP=YES to te generated. 



Specify if user prograrrs may use STXIT PC iracrcs 
QTAM, FORTRAN IV, COEOL-D, and PL/I require 

PC=YES- 



NO ( Specify if private core image libraries are to be 
PCIL=|YES| supported. These have the same format as the 
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systeir core irrage library en SYSPES. You iray 

assxjij private cere iirage libraries to any 
partition. If the linkaqe editor in tc run in a 
foreground Lcjrtition, .i private core irrage library 
iTir^t ::•" 'j!:i ri;' : ly losiqned tc that partition. You 
n.-r, xxiir. - t..ii L [itiuy ii;i";-s U[.,p i rt- j pioarano to run in 
a teieqround partition and pl.iCe^ tt'-ir \ :'i n private 
oore 1 rf a c! e libr.;r" to t, e a o o i c"' n '-'^" ii t^^ ttiit 

( --1 

PD={YES Mh-' !_ T^;^. ranetf^r rrusi- \'^ rppcifi<=d if +-he prcblen 

V n J ^i^^^..t ■ t li 1 M..i t n.,i, pi(.,qrMi!.> i i '. t< l'l..'') -It*- de;;.ired. 

lI -1^... -jp^oilieo that a mrinuiT lE/^REA of 1,400 
oyt';0 lo r *;..:t: rvcj d for thi:;: t::']"'r ii:r . Any amount 
0':/tween i,ULl (otAIEs Ot_ not nee:: a generated 
area) ar:d 1 l. , 2 U u oyteo :ray be specified for n. 

Specify if the supervisor is tc support the fixing 
i NO) and frc.:in:; ;:f pages by ncan:: o^ the PFIX and 
PFIX=\YES f PFRi._ iiacrc instructions. rHix-YEF is forced if 
PHO=YES IS specified in the SUFVF. ir.acro or if 
ECFRLAlj^^YES is specified. PFIX=YES is required 
if you plan to execute BTAM programs in virtual 
mode . 

PRTY= Specify, by ireans of a partition narre sequence, 
(partition name the desired dispatching priority for each 

sequence) partiti;::. The partition specified first has the 
lowest pixciity, the laititicn specified last has 
the iiicihost priority. Cpecify all the partitions 
for which support is geni^-rated by m^ans of the 
NPARTF parameter of the FUFVR macro or by default. 

The partition default priority is as follows: 

Number of 

E£iIl.ili2I]§ Default priority (low to high) 

1 EG 

2 EG,F1 

3 EG,F2,F1 

4 EG,F3,F2,F1 

5 EG,F4,F3,F2,F1 



)=\n / 



PSLD=\n / Specify the number of entries in the Private 

Second Level Directories. A directory is created 
for each partition, unless PCIL=NC. The minimiumi 
value for n is 5. PSLD=NC is assuired if the 
parameter is omitted or incorrectly specified. 
For gccd perf crmance n should be equal tc the 
larnest number of actually used directory tracks 
of ;i private core image litrary. FCIL=NC forces 
PSLD=NC. 

j E9. \ Specify i-F the supervisor is to include the 
REEEDR=(YES /relocatirc leader. This facility allows programs 
to oe loaded into partitions, independent cf their 
link-edited addresses. REILER=YE£ is forced by 
VOa:.l = YES, GETVIS=YES, CL1EF-YES, or RETAFN-YES. 



.nclude 



s ■* ' -^lattiircLyneanDofan 

'a^iIol^I i>iOr j_ ' ^t^tement. 
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i NO ) The RETAIN function is available cr the Model 
RETAIN--^) YES / 14 5 in the United States cf Anerica and Canada 



only. RETAIN is an OLTEf luncticn that allows the 
CLTEt prcqrarrs initiated frcrr a rerrcte location to 
be executed. RETAIN is a prcblerr determination 
tool used by IBM. If this function is to be used, 
specify RETAIN-YES and include the IBM 2955 Retain 
Coininunicaticns Device in the FUE table. External 
interruptions are req;jired for RETAIN operation; 
therefore, if RETAIN=YES is specified, OC=YEE, 
CLTEF=YES, and RELLDR=YE£ are forced. 

NO ] 

SKSEP=jYES I Specify if SEEKS are to be separated from the 

n ) remainder of channel prcgraitis. Se^k separation 

allows other devices on the channel to be accessed 
(inclijdinq other seeks) curing the seek. YES 
indicates support for all DASD type devices 
specified by the DVCGEN rracro at systeir generaticn 
time. n is the nurrber of DASD devices to be 
supported and cannot be less than the number cf 
DASD devices specified at systerr generation. The 
iraxiauii is 2 54. 

Note: If all DASD devices in your configuration 
have Disconnect Chaining (DCC) capability and if 
they are attached to block multiplex channels, 
channel overlap during SEEKs is ircre efficiently 
handled by Block Multiplex Channel Support 
(specify ELKt^PX=YES in the PIOCS iracro) . In a 
mixed DASD configuration, that is a configuration 
consisting cf DASDs with and viithcut DCC 
capability, specify either SKSEP, or SKSEP and 
BLKMPX. 

SLD=)n f Specify the number of entries in the Second Level 
Directory. The minimum value for n is 5. This is 
the default value if the parameter is omitted or 
incorrectly specified. For good performance n 
should be ecual to the number of actually used 
directory tracks in the system core image library. 

NO I 

SYSFIL= j YES I Specify if system input and system output files 

(YES,ni,n2)) (SYSRDR, SYSIPT, SYSLST, SYSFCH) in any partition 
m^ay be assigned to a disk device or an IBM 3 54 
Diskette I/C Unit, oi, if support for the 
procedure library is desired. Specification cf 
YES gives su{_port for all disk devices and the lEM 
3540 Diskette Input/Output Unit. In a 
configuration without tape, specification cf 
SYSFIL=^YES is required for system maintenance 
purposes. If the emulator program parameter SYSIO 
is specified with a value ranging from 200 through 
233, a value must be specified for SYSFIL. 

i:^ - residual capacity for beginning of operator 
notification when SYSFST assigned to disk. 
lC()<ni <65535. If n^ is omitted, 1000 is 
assurred . 

n2 = residual capacity for beqinninq of operator 
notification when SYSFCH assigned to disk. 
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100<n2 <55535. If ris is on-ittp-i, 1000 is 
assuired. 



Not 



1. T^ n„;ii-}-.-r Hi r.r.r ri .., ir rrrcified, the ryerard 
<:^:^ i HOT o h> rl,i("-f ] Mtweoii rMiPnthosos (). 

2. Neither n^ ncr n^ rray re specified if tr.- 
logical units are assigned to an IBM 3540 
Eiskette Input/Output Unit. 

|N0 ) 
TEB=\ n / Specify if tape error statistics are to be 

accurrulated and logged for the 2495 Tape Cartridge 
Reader, where n is the number of tape cartridge 
readers attached tc the systerr. Choose a value of 
n that allows for possible future expansion of the 
systeir . 

TEBV=\CR j Specify hew tape statistir-s ar-^^ tr^ bp 

autorratxcally accuxr.uiated m the i:U52 table and 
logcred on ti.e oYSREC file, Fcr all standard 
labeled tapes, tape statistics are accumulated by 
voluire. For unlabeled cr nonstandard labeled 
tapes two types of error recording are available: 

• Ccrrbined Recording (CR) 

• Individual Recording (IR) 

When TEBV=CR is specified, the error statistics 
for all nonstandard and unlabeled tapes on a 
specific tape unit are accumulated until a 
standard labeled tape is mounted and opened on 
that unit. Then one recording of the statistics 
for the nonstandard, unlabeled tapes is made and 
the counters are reset in the PUE2 table. 

Specify TEBV=IR to record tape error statistics on 
the SYSREC file and reset the PUE2 table counters 
at each OPEN for nonstandard and unlabeled tapes. 

i -^\ 
TOD= (YES / Specify if tirre of dny clock support is desired. 

If YES is specified, GtllKP iracro support is 

provided. Every tirrt: .:i GETIKE is issued, the date 

fields in tfe supervisor coirirur.ication regions are 

updated, if necessary. TOD=NC forces ZONE=NC. 

(NO ) Specif y if the track hold function is to be 
TRKHLD^ n (supported. Specification of TRKHLE generates 
support fcr tne EASD Track Protection Uiacros. 
When processing sequential disk wcrkfiles or 
updates to direct-access files, specify if a hold 
is tc be placed on the track of the record being 
read. The held prevents anyone else that is using 
track hold from accessing that track. The maximuir 
number of tracks that can be held at one time is 
255. The default is 10 if n is an invalid 
parameter (ncnnumeric or outside the range 1-255). 
The NFARTS parameter in the SUPVR iracrc must 
specify more than one partition if iRKHLE=n is 
specified. 
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Note: The track hold functicn is not supported 
for the IBM 3540 Diskette I/C Unit. 

j NO ) Specify if support of the Virtual Storage Access 
VSAM=\YES j Ketncri (vsa;/) is desired. YES is forced for 

GETVIS, AE, and RELLCR if VSAM=YES is specified. 

j NO I Specify if the multiple wait function is to be 
WAITM = '^YES j supported. This functicn allows ycu to use the 

WAITiY rracro to wait for one of a nurrber of events 
to occur. ViAITM^YES is forced if AP=YES . 



/■■-! 



NO 
ZONE= { (EAST, hh, mm) \ For time of day clock support, specify the 

(WEST, hh, mm) ) difference between Greenwich Mean Time (GMT) and 
local time in hours (hh) and rrinutes (irm) . 

Specify EAST for areas to the east of the meridian 
of Greenwich, United Kingdom, cr for areas whose 
time is in a-lvance of GM1 . Specify WEST tor areas 
to trie west. ■: f the meridian cf breenwich. United 
Kingdom, or for areas whose time is behind S[^T. 
The value used in tne ZONE parameter is used tc 
obtain the local tim.e-of -day . If the parameter is 
not specified, or inccrrectly specified, or if 
TOD=NC IS specified, ZONE=NO is forced. If the 
first cperard is inccrrectly specified, EAST is 
assumed . 

Ycu can change the zone value (default is GKT) 
every time ycu perform the IFL procedure, by 
specifyinq any zcne value in the ZCNE parameter cf 
the SET control statement. 

Notes: 



1. Information on the miacrc instructions STXIT, EXIT, SETIME, and 
TTIMER is contained in the DQS/VS Supervisor and I/ C N acros, 
&C33-537J. 

2. The Physical Transient Overlap (PTO) feature and ccirirand chaining 
support for retry on I/C operations (CCHAIN) , optional in earlier 
releases of DOS, have been irade standard. If, however, you 
erroneously specify either PTO or CCHAIN (vihether the operand is YES 
or NO) , the assembler will accept your specification and react only 
by generating an MNOTE, which you need net resolve. 
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PIOCS 



The Physical Input/Output Control Systere (PIOCS) macro instruction and 
its parameters define the configuration requireirents to he supported by 
physical IOCS. If the assuuied options are all satisfactory, the only 
entry required is the PIOCS iracro itself, without any parameters. 



PARAMETERS FOR PIOCS 



BLKMPX 



=(yEs) 



BMPX=|YES j 



Specify if block multiplexer mode is to be 
supported for block irultiplex channels. Block 
Multiplex Channel Support is useful in a 
configuration with DASD devices that have 
disconnect command chaining (DCC) capability and 
are attached to block multiplex channels: all 
3330s, and 3340s fitted with the DCC hardware 
feature (DVCTYP=3340R specified in the DVCGEN 
macro or in the IPL ADD command) , and the 
following buffered card and print devices: 25U0, 
1U03, 3211. 

Not e; In a DASD configuration that consists of 
devices with DCC capability only, there is nc need 
to specify SKSEP=YES or n in the FCPT macro as 
Block Multiplex Channel Support provides channel 
overlap during SIJEKs in a m.ore efficient way. 
Moreover, the code generated by a specification of 
SKSEP=YES is then bypassed if BLKMPX=YES is 
specified. 



Specify if burst mode devices are supported en a 
byte-multiplexer channel. If YES is specified, 
unbuffered (cverrunnable) devices will not be 
allowed to execute I/O concurrently. If 1419s or 
1255/1270/1275S are attached to the 
byte-multiplexer channel, EMPX=YES may be 
specified. However, burst mode and MICR devices 
cannot run concurrently on the same 
byte-multiplexer channel. 

i m) 

CHANSW=< RWTAU > 

(tswtch ) Specify if channel switching for tape control 
units is to be supported. For a 2404 or 2804, 
enter CHANSW=RWTAU. For a 2816 (with a 2403 or 
2803) or a 3 803 enter CHANSW=TSWTCH. If 
CHANSW=RWTAU or TSWTCH is specified and TAPE=NO is 
specified, TAPE=7 is forced. Channel switching 
allows a device to be addressed via two adjacent 
selector or block-multiplexer channels. 



DISK= 



2311 
2314 
3330 
3340 
1(3330,3340)/ 



Support for the IBM 2311, 2314/2319, and 2321 is 
default. Specification of DISK=3330 gives support 
for all attachable DASD devices, except the IBM 
3340. Specification of DISK=3340 gives support 
for all attachable DASD devices except the IBM 
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3330. Specify DISK= (3330,3340) if support for 
both devices is desired. 



NO 
MRSLCH= I YES 



Note; DISK=3340 is the only valid specification 
for the Model 115. Specification of DISK=2311 or 
2314 is not valid for the Model 125. If M0DEL=115 
and DISK*3340, DISK=3340 is forced. If MODEL=125 
and DISK#3330 or 3340, DISK=3330 is forced. 



Specify if MICR device is on the selector channel 
(can only be specified fcr the 1419 single address 
device) . 



TAPE=j 9 

(no 



Specification of TAPE=7 generates support for both 
7- and 9-track tape. TAPE=7 is forced by a 
specification of EVA=(r,vi) and by CHANSW=RWTAU or 
TSWTCH. If MODEL=125 and TAPE=7, or 9, CHAN=YES 
ir.ust also be specified. In a configuration 
without tape, specification of SYSFTL=YES is 
required for system iraintenance purposes. 

Note: Selector channel support is standard in 
DOS/VS. The parameter SELCH=, used in prior DOS 
releases, is ignored. 



VSTAB 



The Virtual Storage Table and Buffer Build (VSTAB) iracrc instruction and 
its parameters define the size of the real and virtual address areas and 
of the Shared Virtual Area (SVA) , and specify the nurrber of buffers 
required for channel prograir translation. Tables, for trapping the real 
and virtual address areas, and buffers are generated within the 
supervisor area. The iraxirruir value you can specify for VSIZE is 16,000K 
(16,777,216 bytes) minus the size specified for the real address area 
(RSIZE). Specification of this rracro is required. The VSTAB macro is 
discussed in greater detail in the DOS/VS Systeir Management Guide, 
GC33-5371. 



PARAMETERS 

VSTAB RSI 



FOR VSTAB 



5' 



x^ 



C>^ 



ZE=| 96K 
nK 



RSIZE=nK 



, VSIZE^JnPARTS*64K+SVA sizel [,EUFSIZE=n] ,SVA= ((64K^0K) 
(nK ) ((nK,ffK) 

Specify the size of the real address area, where n 
must be > 64 and a multiple of 2. If an odd number is 
specified, a value of 1 is added to it. If the 
operand is omitted, a value of 96K is assumed. The 
value specified is used to build the tables that map 
the real address area and to define the beginning of 
the virtual address area. (End of real address area = 
beginning of virtual address area.) 

If you select a value fcr RSIZE that is larg er than 
the amount cf real storage in the CPU model used fcr 
system generation (with an eye to also using your 
system on a CPU with larger real storage) , the address 
area between the end of real storage and the beginning 
of virtual storage will not be used. 
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If you select a value for RSIZE that is smaller than 
the actual amount cf real storage in the CPU on which 
your system is to be used, any real storage beyond 
your RSIZE cannot be used, and a warning message is 
issued at IPL time (provided that you IPL from the 
console keyboard) , informing you that a part of real 
storage is not used. If you IPL from the card reader, 
however, the miessage is suppressed. 

VGIZE=fNPARTS*64KJ Specify the size of the virtual address area (which 

t§Y^_§ize_ { includes the Shared Virtual Area - SVA) , where n must 
|nK I be at least 64 times the nuirter of partitions 

J specified by the NPARTS pararreter and a irultiple cf 2, 
plus the size ot the Shared Virtual Area (SVA). If an 
odd number is specified, a value cf 1 is added tc it. 
If the operand is emitted, a value of 6U times th^ 
number cf partitions specified by the NPARTS pararreter 
is assumed. The value specified is used to build the 
tables that map the virtual address area, to determine 
the size of the disk extent for the page dat.i set, and 
to define the end cf the virtual address area. 

BUFSIZE=n Specify the number of copy blocks (buffers 

with a length cf 72 bytes) tc be used by the Channel 
Program Translation routine. Specification of this 
parameter is optional. If the operand is omitted and 
the NPARTS parameter specifies a value greater than 1, 
a value of 30 is assumed. The default is 10 if 
NPARTS=1 is specified. The minimum value that can be 
specified, regardless of the NPART£= specification is 
10- 

SVA= )(64KyOK)l 

(nK,mK) j nK specifies the size cf the Shared Virtual Area 

(SVA) ; mK specifies the size of the system GETVIS area 
in the SVA. n must be at least 64 and a multiple of 
2. m must be smaller than n and alsc a multiple cf 2. 
If the operand is omitted cr incorrectly specified, 
the default value is taken. If your system is 
generated to include VSAK support, specify 
3VA=f 2CCK, OK) . 

Note; This parameter is only valid if the NPARTS 
parameter of the SUPVR macro specifies more than one 
partition (NPARTS=>1) . 
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ALLOC 

The Allocate (ALLOC) macro instruction defines the partitioning of the 
virtual address area in a irultiprcgramring systeir. Specif i cation of 
j^^ji:g-fl}§9£9..-j:g ..9E^i°?>§l. fa^c:ause the operator can also allccate the 
yirtual__ storage address_area. It can only be specified vvith at least 
one parameter. Specify the size of the virtual foreground partitions 
only. The system computes the size of the virtual background partition 
by subtracting the total airiount of virtual storage allocated to the 
virtual foreground partitions froin the virtual address area as specified 
by the VSIZE parameter. When specifying the ALLOC macro, see to it that 
the size of the background area does net fall below 6UK bytes. If the 
macro is omitted, the entire virtual address area is allocated to the 
virtual background partition and the size of each virtual foreground 
partition defined is set to zero. The ALLOC macro must not be used if 
NPARTS=1 is specified. 

PARAMETERS FOR ALLOC 

ALLOC Fl=nK,F2=nK,F3=nK,Fi»=nK 

The operands may be specified in any order, n must 
be a multiple of 2 . If an odd number is specified, 
it is replaced by the next higher even number. The 
minimum value substituted for n may not be less than 
64. A zero specification is accepted, however. Any 
specification from 1 through 63 is reset to zero. 

If the sum of the sizes specified for all foreground 
partitions plus the SVA plus 64K exceeds the size as 
specified by the VSIZE parameter, the ALLOC macro is 
ignored by the assembler, which issues an MNOTE to 
that effect. 

S ystem-Used Area s 

All partitions contain a partition save area for 
program name, interrupt status inforrration, and 
registers, as well as a label save area for label 
processing if the LBLTYP jcb control statement is 
used. Both areas are at the beginning of the 
partition. 

Save area length is 88 bytes, or 120 bytes if the 
floating-point feature (FP=YES) was specified in the 
CONFG macro. 

Label area length is determined by the system 
according to the LBLTYP specification: 

• TAPE (standard tape labels) =80 bytes 

• NSD (nn) (ncnseguential disk) = 84 bytes plus 20 
bytes per EXTENT statement 

• Omitted = bytes. 

The .size of each virtual partition must be large 
enough to contain both the program and the save 
areas. 
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ALLOCR 

The Allocate Real Storage (ALLCCR) iracro instruction allocates available 
real storaae to your partitions (as defined by the NPARTS= parameter of 
the r/JPVR niacro) . 

In a raultiprogramrning systerr, available real '=fcraa(= is th^ real 
storage size of your CPU as specified hy t b.*> RriZE pararrefer of the 
VCTAB n,acro, less the size cf your supcrvi::cr. In a sir.qle partition 
syste;i (:iFARTS = l) specification of the ALLOCR rracrc is r^ct accepted. 
7^.11 jvdilable real storage is alvvays allocated to the background real 
partition. 

The ALLOCR macro instruction is cr:tional, since available real 
storage can also be allocated or reallocated by ireans of the ALLOCR 
cr.TTif : ': !. ALLOCR must be specified with at least one parameter. Specify 
tne ^j.^e of each real partition ycu desire (including the background 
partition) . If a partition is onnitted, it is allocated a real partition 
size of zero. All available real storage net allocated to real 
partitions is allocated to the Page Pool. Bear in mind that programs 
executing in virtual mode and using the PFIX iracro instrncticn require 
an allocated real partition whose size is not less than the maximuir 
number of pages concurrently fixed by PFIX. 

All of available real storage may be allocated to real partitions 
with the exception of: 

• 18K bytes minus the size cf the smallest real partition if the 
smallest real partition is 18K bytes or less and PFIX=NO (plus 2K 
bytes if AP=YES) . If the SDL (System Directory List) is active, 
however, the m.ain page pcol must be at least 4K bytes. 

• 18K bytes if PFIX=YES (plus 2K bytes if AP=YES) . 

• 18K bytes if phases from the SVA are to be executed. 

At IPL time, the partition allocation of real storage is checked to 
see if the above rules have been obeyed. If the allocation exceeds the 
maximum allowed, all real partitions are set tc zero, and an operator 
message is issued. The operator can correct the problem, with an ALLOCR 
command. 

PARAMETERS FOR ALLOCR 

ALLOCR BGR=nK,FUR=nK,F3R=nK,F2R=nK,FlR=nK 

The operands may be specified in random order. n 
must be a multiple of 2. If an odd number is 
specified, it is replaced by the next higher even 
number. For each real partition allocated, the 
corresponding virtual partition must be allocated 
too, because the job control program, runs in virtual 
mode. 

§ Y§^ m-Used Areas 

The size of each active real partition must be large 
enough to contain both the program to be executed 
and the partition and label save areas (see the 
I description of the ALLOC macro). 
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lOTAB 



The Input/Output Tables (lOTAB) macro instruction and its parameters 
define the area for the necessary device tables for the system. If the 
assumed options are all satisfactory, the only entry required is the 
lOTAB macro itself without any parameters. 



PARAMETERS FOR lOTAB 



iig 

BGPGR=) n 



==l^i 



BSCLNS= 

(Models 115 and 

125 only) 



Specify the number of syirbolic programmer 
logical units (SYSOOO-SYSnnn) assigned to the 
background partition. The miniiruir number is 10. 
The maxiirum depends on the number of partitions. 
See Note, which follows. 

If the TP parameter in the SUPVR macro 
indicates teleprocessing support and the MODEL 
parameter of the CONFG miacro specifies 115 or 
125, this parameter specifies the number of ESC 
lines in the system. The value given must be in 
the range of - 4 for the Model 115 and 0-6 fcr 
the Model 125. 



CHANg=j 8 

6 

^ n 



Specify the maximum number of entries to be 
generated for the channel queue. If the 
parameter is omitted, the following defaults are 
taken: 



Default value 

NPARTS=l-3: 6 plus value specified by CBF 

parameter. 
NPARTS=4 : 8 plus value specified by CBF 

parameter. 
NPARTS=5 : 10 plus value specified by CBF 

parameter. 

The number of entries specified should exceed the 
total number of I/O requests you wish to 
accumulate simultaneously. The requests for I/O 
commands for all channels are stored in this queue 
and are net released from the queue until the I/O 
operation has completed. The maximum value 
generated is 255. (See the DOS/VS System 
Management Guide, GC 33-5371, for a detailed 
discussion of this parameter.) 

D2311=n Specify, for each I/O device listed at the left, 

D2314=n the number of drives that are attached to your 

D2321=n system. 
D2400=n 

D3330=n If the device is not specified, the system 

D3340=n assumes that no devices of that t^^^pe are 

D3410=n attached. However, defaults other than zero are 

D3420=n taken depending en the CPU Model specified and 

D35tt0=n (for tape devices) whether PIOCS tape support is 

D3886=n generated or not (see table below) : 
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r T 

|Default|PIOCS 

I if I Macro: J-- 



CCNFG Macro 



JTAPE= 9 



I 

[ + 

|D2314=2 1 

|D2400=4| X 
^ + 



M0DEL=115 



MODEL=125|MODEL=135, 145, 
1 155-11, cr 158 






I X 
-— + 

I X 
■+ 






1D3330=2| 
|D3340=2| 



X 






h 



■-+- 



1 
+— 

1 

X. 






|D3410=2| X 
•- X 



The nuirber specified for each drive may be ircre 
than the actual number attached, but if the tota l 
number of devices specified exceeds the nuirber cf 
devices specified in the lODEV parameter, the 
latter number is upgraded (total number of devices 
specified by the Dxxxx parameters plus 5 for unit 
record devices) . 



FlPGR=in*i 
F2PGR=ln*) 
F3PGR=ln* ) 
F4PGR=ln* I 



Specify the number of symbolic programmer 
logical units (of the class SYSnnn) for the 
Foreground partitions. The itiinimuir value for n 
is 5, while the iraxirrum depends en the number 
of partitions (see Note) . 

♦Note: For an unsupported partition n=0 is 
assumed. The maximum values for the sum of all 
n's are as follows: 



(-1 

I0DEV=1 n) 



JIB 



J^l 



r T 

I Nuirter of partitions | 

h T T T T -f 

I 1 I 2 I 3 I 4 I 5 I 

JMaximum value for I I I I I 1 
|sum of n's: | 241 | 227 | 213 | 199 | 185 | 

L i_-, L i. X X J 

Note: The iraximum nuirber cf programm.er logical 
units you can assign to a specific partition is 
the iraxirrurr for the systeir minus the sum of the 
units assigned to all ether partitions. 



Specify the number of I/O devices and 
communication lines attached to the system. The 
maximum is 255, The minimum value is 6. Each 
unit requiring a DVCGEN cr ADD entry m.ust be 
included in n. 

Specify the number of JIEs (Jot Information 
Blocks) for the systeir. 

Requirements are: 

1. One JIE for each logical unit temporarily 
reassigned by a // ASSGN statement that 
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differs from standard system assignment (that 
is, established at IPL time) 

2. One JIB for each alternate logical unit 
assignment 

3. One JIE for each open 2311, 23m, or 2319 
extent with the DASD file-protect feature 
except fcr systeir input/output extents 

4. Two JIEs for each open 2321, 3330, or 3340 
extent with the DASD file-protect feature. 

The iriniirum value generated is 5. The maxirrurr is 
255. 



SSLNS=ln) 
(Models 115 and 
125 only) 



If the TP parameter in the SUPVR macro 
indicates teleprocessing support and the MODEL 
parameter of the CONFG macro specifies 115 or 125. 
this parameter specifies the number of Start/Stop 
lines in the system. The value given must be in 
the range 0-8 for the Model 115 and 0-16 for the 
Model 125. 



DVCGEN 



The Device Generation (DVCGEN) macro instruction and its parameters 
define the physical input and output units attached to the system. This 
m.acro instruction is optional. The DVCGEN iracrc is further discussed in 

the DQS/ys System__Management Guide, GC33-5371. 



PARAMETERS FOR DVCGEN 



CHUN=X'CUU' ,DVCTYP=XXXXXX,CHANSW= jNO i,MODE=X'ss' 

lYEsl 



CHUN=X'cuu' 



Specify the hexadecimal number of the channel 
and unit for the device. If channel switching 

is supported, c must indicate the lower 
channel. 



DVCTYP=xxxxxx 



NO 

CHANSW=(YES 



Specify the device type. Figure 1-4 contains 
the codes for each IBN-supported device. 



Specify if the device is attached to more than 
one channel on one system, that is 

a. 2 selector channels 

b. 2 block multiplexer channels, or 

c. 1 selector channel and 1 block multiplexer 

channel 

Ncte: DOS/VS requires that the channels have 
consecutive addresses (for instance channels 1 
and 2) . 

This parameter indicates if the device can be 
switched (IBM 2816 (with a 2403, 2803, or 
3803), 2804 or 2404 available). 
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MODE=f X'SS' 

X'SSSS' 

iX* ssssss' 



1. 2U00T9. MODE specifies the tape mode. 
X'CO* is the default value. For 800 tpi 
9-track single density, specifying X*C8' 
saves time during tape OPEN. 

2. 3410T9, MODE specifies the tape mode. 
X'CO' is the default value. 

3. 3U20T9. MODE specifies the tape mode. 
X'CO* is the default value. 

4. 2U00T7 or 3U20T7. MODE specifies the tape 
mode. X'90' is the default value. 

5. 2702. MODE designates the SADxxx command. 



X'OO' 


SADO 


(default) 


X*01' 


SADl 




X*02' 


SAD2 




X'03« 


SAD3 





See "IPL Control and ASSGN Statements for 
Systeir Generation" for other values of ss . 

6. 2260 (Local) and 3270 (Local). MODE 
specifies the 1053, 3284, or 3286 printer 
when CHUN=X*cuu' refers to a 1053 attached 
to a 2848, a 3284 attached to a 3272, or a 
3286 attached to a 3272, respectively. The 
operand must be entered as MODE=X'01'. 

7. 1419/1255/1259/1270/1275. MODE designates 
the external interrupt bit associated with 
magnetic ink character readers or optical 
reader/sorters. The mode X'Ol* through 
X*20' corresponds to external interrupt 
PSWs bits 26 through 31, respectively. For 
dual address adapter 1419, this parameter 
is needed for both 1419P and 1419S. 



X'Ol' Device attached to external line 7. 

X'02' Device attached to external line 6. 

X*04' Device attached to external line 5. 

X'08* Device attached to external line 4. 

X'lO' Device attached to external line 3. 

X'20' Device attached to external line 2. 

8. 1018. MODE specifies whether the 
error-correction feature is present or not. 
X'OO* feature not present (default value). 
X*01* feature is present. 

9. 2703. For the IBM Models 115 and 125 with 
the Integrated Coirmunications Adapter, 

MODE=x*ss', MODE=X'ssss' , or MODE=X' ssssss* 
specifies the line mode setting for a 
Start/Stop or ESC line if the TP parameter 
in the SUPVR rracrc indicates teleprocessing 
support and the MODEL parameter in the 
CONFG macro specifies 115 or 125. If a one 
or two byte value is specified, the 
specified value is right- justified and 
padded with zeros on the left to fill the 
three bytes. Thus, to specify a 
single-byte value for a Start/Stop line 
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that requires only one byte, you must 
supply a three-byte value, the leftirost 
byte of which contains the requested mode 
settings. The line mode setting and its 
default settings are discussed in 
Systerr/370 Model 125 Functional 
Characte r istics , GA33-1506 and in 
Systeir/370 Model 115 Functional 
Characteristics, GA33-1510. 

10. 3705. MODE specifies the type of channel 
adapter. No default is assumed. 
X'Ol' Type 1 channel adapter 
X'02* Type 2 channel adapter 

If the MODE parameter is oiritted or 
incorrectly specified, the assembler issues 
an MNOTE. 



I RULES FOR USING DVCGE 



N 



I 



1. A separate DVCGEN macro instruction is required for each device. 
For a 2314, 2319, 3330, or 3340 each individual unit needs a DVCGEN 
card. 

2. The total number must not exceed the total number of devices 
specified in the lODEV parameter of the lOTAB macro. 

3. DVCGEN macros must be specified in ascending channel address 
sequence. 

4. Switchable units attached to more than one channel, that is 

a. 2 selector channels 

b. 2 block multiplexer channels, or 

c. 1 selector channel and 1 block multiplexer channel, 

must be defined only once on the lowest channel by which they are 
addressable. They cannot be redefined as ncnswitchable units en the 
higher channel. 

5. The sequence of the DVCGEN cards determines the position of the 
devices in the PUB table. SYSRES should be the first DVCGEN card if 
it is to have the highest software priority for that channel. 
Switchable units must be the last devices specified for each channel 
and must be on consecutive channels. 

6. The specifications of these macros can be altered at IPL by ADD and 
DEL statements. 

7. IBM 3210/3215 Console Printer-Keyboards that are not online but were 
defined by DVCGEN statements must be deleted by DEL statements when 
performing IPL from the card reader. 



I ASSGN 

The Assign (ASSGN) macro instruction and its parameters assign symbolic 
device names (LUBs) to physical I/O devices (PUEs) . A separate macro 
instruction is required for each symbolic device name with a standard 
system generation assignment. This macro instruction is optional, 
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however, since the assignments can also be irade after IPI. If the 
assignment is made at system generation time, the system uses it as a 
default assignment. 



PARAMETERS FOR ASSGN 



SYSnnn,X'cuu' 



,BG 
,F1 
,F2 
.F3 



m 



Symbolic name miay be any cf the following 
system logical units or programmer logical 
units: 

SYSRDR SYSLST SYSREC 
SYSIPT SYSLOG SYSPLB 
SYSPCH SYSLNK SYSSLB 
SYSCAT 

SYS00C-SYS2UO (1-partition systeir) 
SYS00C-SYS221(2-partition system) 
SYS000-SYS202 (3-partition system) 
SYS000-SYS193 (U-partition system) 
SYS000-SYS164 (5-partition system) 

X 'cuu' is the hexadecimal number of the 
channel* and unit to vvhich the symbolic device 
is attached. A separate macro is required for 
each standard assignment desired. 

*must be the lower of two channel numbers if 
channel switching is supported, 

BG, Fl, F2, F 3, or FH specifies the partition 
to which the assignment is being made. The 
ASSGN iracro is ignored if a specification is 
entered for a partition not defined by the 
NPARTS parameter of the SUPVR macro, or net 
defined by default if the NPARTS parameter was 
not specified. If the parameter is omitted, 
while the next parameter is specified, indicate 
the omission by separating the last and the 
next parameters by means of two commas. 

HI or H2 specifies the desired input hopper to 
be used fcr an IBM 2560 or 5t»25. If both 
hoppers are to be used, they must be separately 
assigned to the same partition by means of two 
ASSGN macros. If the operand is omitted HI is 
assumed. 



liS^te: H2 may only be assigned to SYSRDR, 
SYSIPT, or SYSPCH. H2 must not be specified if 
the IBM 2560 or 5425 is assigned to a partition 
supported by POWER. 

I Making a standard foreground assignment at system generation time is 
equivalent to making a permanent assignment after IPL. When you unbatch 
a foreground partition, temporary assignments are released. 

System I/O units (SYSRDR, SYSIFT, SYSLST, cr SYSPCH) that are 

assigned to a tape, a 35U0 Diskette, or DASD when the system is 

generated are unassigned by IPL. An unassigned device can cause a job 
to be canceled. 
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Notes: 



During system generation, conflicting assignments (ASSGN macro 
specifications made in the supervisor asseirtly) across partitions are 
not checked. 

If SYSLOG is assigned to a foreground partition, it must also be 
assigned in the background partition. 

Compile, link-edit, and go in a foreground partition is allowed only 
if a private core iirage library is supported and available. 
Therefore, SYSLNK must be assigned to a foreground partition if 
PCIL=YES has been specified and NPARTS>1. Note that the assignment 
can also be made at execution time. 



DPD 

The Define Page Data Set (DPD) iracro instruction and its parameters 
define the page data set (SYSVIS) that is to hold the virtual address 
area . Specification of this macro is opticnaly since the data set can 
also be_defined after IPL by means of the DPD ccirmand. It provides 
information about the channel and unit number of the paging device, disk 
starting address of the SYSVIS extent and the volume serial number. 

If the macro is omitted or incorrectly specified, the page data set 
must be defined at IPL time by means of the DPD command (see the DOS/VS 
System Management Guide, GC33-5371). This command can also be used to 
override the information supplied by the DPD macro, until the next IPL. 

The IPL routines open the page data set, check its extent limits, 
create label information for inclusion in the VTOC, and assign the 
symbolic name of SYSVIS to the page data set. 

Note; The ASSGN statement or command cannot be used to assign or 
re-assign SYSVIS. 

PARAMETERS FOR DPD 

DPD UNIT=X' cuu' ,CYL=nnn, VOLID=xxxxxx 

UNIT=X'cuu' Specify (in hexadecimal notation) the channel and 
unit number of the device that is to contain the 
page data set. (If UNIT is specified, then CYL must 
also be specified.) 

CYL=nnn Specify the number of the cylinder where the page 

data set is tc begin. The upper limit of the extent 
is computed by the system en the basis of the 
information supplied in the VSIZE parameter of the 
VSTAB macro. The assembler issues an MNOTE 
indicating the required number of tracks. (If CYL 
is specified, UNIT must also be specified.) 

VOLID=xxxxxx This parameter is optional. It specifies the volume 
serial number cf the disk pack and is used for label 
checking. If the parameter is not specified in 
either the DPD macro or the DPB command, the volume 
serial number is not checked. 
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SEND(n) 
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(niiN'j) iracrc instruction indicates the address of the 
.:; (rrL:Lc;). ririiG i:,; alvvays en a 2K tciHidary and 
coiii.:ide^; v.ith the address at the end cf the stipervisor (EOSSP) . 
Regardless of whether the .SENI^ rracro is specified with or without the n 
paraireter, the generated supervisor is always fully stcraoe-protccted . 
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If your supervisor includes the relocating loader, nc relink-editing 
is required for prograirs that were link-edited relccatable for a real 
partition. Moreover, because the address of the virtual background area 
is independent of the supervisor end address, expansion of the 
supervisor never involves relink-editing of prcqrairs that are 
link-edited for a virtual partition. 



Note: The DCS /VS asseirbler requires an END and a 
the SEND macro. 



/* staterrent following 



PARAMETERS FOR SEND 



Specify the desired address (FPEEG) of the real address 
area for use by prograirs ether than the supervisor. 
Depending on the value selected for n, the assembler takes 
the following actions: 



specified? 



T T 

n = rrultiple 
cf 20 ^S 



4- 



YES 



YES 



YES 

YES 
NO 



-+- 



YES 



NO 



YES 



NO 



n>size of 
generated 
supervisor? 



-+- 



YES 



YES 



NO 



NO 



Asseirbler action 
taken 



Specification is 
accepted. 



Address specified is 
stepped up to next 
higher 2K boundary. 



Address specified 
replaced by generated 
supervisor end 
address (PPBEG) . 



Address cf PPBEG 
established on 2K 
boundary. 



Figure 1-2. Supervisor End Address Corriputation on the Basis 
of Different SEND Macro Specifications 
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Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 



r w 



The Supervisor 
Macro options 
specified 

below require ( R) 
or force (F) 
other options 
as specified 
on the right. 



A 



BSCLNS 



D SSLNS 



< ERRLOG=RDE 



TAPE # NO 



M0DEL:::.n5 



-J —____—_ 
^ MODEL=125 



1—1 ________ 

O DOC=125D 



POWER = YES 



TP = QTAM 



AP=YES 



AP = NO 



ECPREALrz:YES 



EVA = (r,w) 



CHANSW ^ NO 



TOD = NO 



PHO = YES 



VSAM = YES 



GETVIS = YES 



a: OLTEP - YES 



RETAIN = YES 



PCIL=NO 



JALIOCS=(s.ll 



IDRA = YES 



TRKHLD = n 



ALLOCR 



SVA=(nK,mK) 



Figure 1-3. SUPERVISOR — Macro Instructions 
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Card Code 


Actual IBM Device 


Dev. Type 
X'nn' 


Device Type 


7770 


7770 Audio Response Unit 


D3 


Audio Response Units 


2501 
2540R 
3505 
3504 


2501 Card Reader 
2540 Card Reader 
3505 Card Reader 
3504 Card Reader 


10 
11 
12 
12 


Card Readers 


2540P 

2520B2 

1442N2 

2520B3 

3525P 


2540 Card Punch 
2520B2 Card Punch 
1442N2 Card Punch 
2520B3 Card Punch 
3525 Card Punch 


21 
20 
22 
20 
23 


Card Punches 


1442N1 

2520B1 

2560 

2596 

3525 RP 

5425 


1442N1 Card Read Punch 

2520B1 Card Read Punch 

2560 Multy - Function Card Machine 

2596 Card Read Punch 

3525 Card Punch (with optional read feature) 

5425 Multifunction Card Unit 


30 
31 
33 
30 
23 
34 


Card Read Punches 


2311 
2314 
2314 
2321 
3330 

3340 R 
334GR 
3340 
3340 


231 1 Disk Storage Device 

2314 Direct Access Storage Facility 

2319 Disk Storage Facility 

2321 Data Cell Drive 

3330 Disk Storage - 1 , 3330 - 2, or 3333 - 1 

3340 Disk Storage with 
DCC feature (with or 
without 3340 Data 
Module, Model 35) 

3340 Disk Storage with 

DCC feature (with or 
without 3340 Data 
Module, Model. 70) 

3340 Disk Storage without 
DCC feature (with or 
without 3340 Data 
Module, Model 35) 

3340 Disk Storage without 
DCC feature (with or 
without 3340 Data 
Module, Model 70) 


60 
62 
62 
61 
63 

69 
6A 
69 
6A 


DASD 


3540 


3540 Diskette Input/Output unit 


80 


Diskette Storage Device 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


125 D 
125 DP 


Model 125 Integrated Display 
Operator Console 
Model 125 Integrated Display 
Operator Console with 5213 
Console printer attached 


B2 
B2 


Display Operator Console 


2260 
3277 

(local 3270) 
3277 B 
(local 3270) 


2260 Display Station 

3277 Display Station; MODE 

operand need not be entered 
3277 Display Station; attached in Burst 

Mode to a inultiplexer channel. 

MODE operand need not be entered 


CO 
BO 

BO 


Display Stations 


2400T9 
2400T7 


9 - track Magnetic Tape Units I „«„„ 

... . -r . , • r 2400 - series 
7 - track Magnetic Tape Units J 


50 
50 


Magnetic Tape Devices 



Figure 1-4. SUPERVISOR — Device Code (Part 1 of 2) 
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Card Code 


Actual IBM Device 


Dev. Type 
X'nn' 


Device Type 


341 0T9 
341 0T7 
3420T9 
3420T7 


9 - track 3410 Magnetic Tape Units 
7 ■ track 3410 Magnetic Tape Units 
9 - track 3420 Magnetic Tape Units 
7 - track 3420 Magnetic Tape Units 


53 
53 
52 
52 


Magnetic Tape Devices 


1419 

1419 

1419 

1419P 

1419S 


1255 Magnetic Character Reader 

1259 Magnetic Character Reader 

1419 Magnetic Character Reader 

1419 Dual Address Adapter Primary Control Unit 

1419 Dual Address Adapter Secondary Control Unit 


72 
72 
72 
73 
74 


MICR - Magnetic Ink Character Recognition 
Devices 


1419 
1419P 
1287 
1288 

3881 
3886 


1270 Optical Reader Sorter 
1275 Optical Reader Sorter 

1287 Optical Reader 

1288 Optical Page Reader 

3881 Optical Mark Reader 
3886 Optical Character Reader 


72 
73 
77 
77 

11 
7C 


Optical Readers 


1018 


1018 Paper Tape Punch with 

2826 Control Unit Model 1 


79 


Paper Tape Punches 


1017 
2671 


1017 Paper Tape Reader with 
2826 Control Unit Model 1 

2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 


1403 

1403U 

1443 

2260 (Local) 

3203 
3211 
3277 (Local 3270) 

3277B 
(Local 3270) 

5203 
5203 U 


1403 Printer 

1403 Printer with UCS feature 

1443 Printer 

1053 Printer with 2848 Control Unit 

MODE operand must be entered as X'01' 

3203 Printer 

321 1 Printer 

3284 or 3286 Printer with 3272 Control Unit, 
MODE operand must be entered as X'01' 

3284 or 3286 Printer with 3272 Control Unit, 
attached in Burst Mode to a multiplexer 
channel. MODE operand must be entered 
as X'01 ' 

5203 Printer 

5203 Printer with UCS feature 


40 
42 
41 
CO 

4A 
43 
BO 

BO 

4C 
4D 


Printers 


1050A 


3210, 3215 Console Printer Keyboards 


00 


Printer Keybord 


2495TC 


2495 Tape Cartridge Reader 


51 


Tape Cartridge Reader 


2701 
2702 1 B 

Id 

2703 


2701/2715 Data Adapter Unit 

2702 Transmission Control Unit 

2703 Transmission Control Unit 


DO 
D1 

D2 


Teleprocessing lines 
C A = SADO command when enabling the line 
I B = SAD1 command when enabling the line 
I C = SAD2 Command when enabling the line 
[ = SAD3 command when enabling the line 


2703 
2703 


3704/3705 Communications 
Controller in Emulation Mode 

Model 125 or 135 Integrated 
Communications Adapter 


D2 
D2 




UNSP 
UNSPB 


Unsupported Device 
Unsupported Device 


FF 
FF 


Unsupported No burst mode on multiplexer 

channel 

Unsupported with burst mode on multiplexer 

channel 
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Supervisor Etement 


Generation 
Operarxl 


NPARTS- 1 




Multipr(_M 


ramminq 




Comments 


NPARTS^2 


NPARTS=3 


NPAHTS=4 


NPARTS=5 


SUPVR (Hequired Rout 
H.fi Bdsic3i/Hi 

SVC Interruption Handling 

System Loader (FETCH and LOAD) 

Minimum I/O Units Control Tables 

(LUBs,PUBs,andJIBs) 

General Entry and Exit Routines 

System Communication Region 

Partition Communication Regions 

Transient Areas 

End of Job Step 

Byte Multiplexer and Selector Channel Support 

Storage Protection 

CCW Translation 

Page Management 

2311/23T4 Disk Error Recovery 




20964 


26448 


26964 


27544 


28096 


Based on M0DEL=1 15 or MODEL=125 
















OationaJRputines 
















Multitasking 

ASCII/EBCDIC Translation Tables 


AP=YES 
ASCII=YES 


N.A. 
512 


4704 
512 


4488 
512 


4264 
512 


4048 

512 


1) Forces WAITM=YES 

2) Forces NPARTS=3 if NPARTS omitted or 
specified as 1 


RMSR-support for 
Channel-attached devices, 
tape units, or TP-devices 
used with a Model 1 15 or 125 


CHAN=YES 


912 


960 


960 


960 


960 


If RMS=YES or MCH=YES is also specified, add 
the value given for RMS instead. 


Reliability Data Extractor 
Error Recording (IPL, EOD) 


ERRI.OG=RDE 

















For Model 1 15 or 125, CHAN=YES or RMS=YES 
is required 


14xx Emulators 


EU = YES 


200 


224 


224 


224 


224 




Model 115/125 MCAR/CCH 
support 


MCH = YES 


4576 


4568 


4568 


4568 


4568 


If RMS=YES or CHAN=YES is also specified, add 
the value given for RMS instead 


Magnetic Ink Character 
Reader 


MICR = 1419 

(for125»'1259/1270/1275s 
see Note 1 ) 


912 


1160 


1160 


1160 


1160 






MICR = 14190 

( Dual Address Adapter 

1419/ 1275 s) 


1024 


1,024 


1,024 


1,024 


1,024 




Page Handling 


PAGE IN=n(n must be >1) 


1408 + 
8n 


1592 + 
8n 


1592 + 
8n 


1592 + 
8n 


1592 + 
8n 




Page Exception Handling 
Overlap 


PHO = YES 


616 


656 


648 


672 


672 


Forces PFIX = YES 


POWER 


POWER = YES 


N.A. 


312 


312 


312 


312 


Forces NPARTS =3,if NPARTS omitted or 
specified as 1 


RMS support ( RMSRplus MCA/CCH) 
for Model 115 and 125 


RMS = YES or CHAN = YES and 
MCH = YES 


5440 


5480 


5480 


5480 


5480 


Do not include any values for CHAN=YES 
and for MCH=YES 


Tttlproca»ing 


TP = BTAM 
TP = QTAM 
TP-aTAMn($eeNote2) 


560 
NA 
NA 


544 
1072 
1032 


544 
1072 
1032 


544 
1072 
1032 


544 
1072 
1032, 


TP= QTAM forces NPARTS = 3 if NPARTS is 
omitted or specified as 1 



Figure 1-5. SuperviGor Real Storage Requirennents--Bytes (Part 1 of 8) 



Module 1: Planning and Procedures b9 



Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 



Supervisor Element 


Generation Operand 




Multiprog 


ramming 




( 


NPARTS=1 


NPARTS=2 


NPARTS=.3 


NPARTS=4 


NPARrS=^5 


\ 


CONFG 
















(configuration Options) 
















Floating Point Feature 


FP=YES (default) 





72 


72 


72 


72 




Model 115 


M0DEL=115 

















Forces Disk=3340 and DOC=125D 


Model 125 (see Note 7) 


MODEL=125 

















Forces Disk=3330 (if neither 3330 nor 
are specified) and DOC=125D 


Model 135 


MODEL=135 


5440 


5480 


5480 


5480 


5480 


RMS support 


Model 145 


MODEL=:145 


599? 


6032 


6032 


6032 


6032 


RMS support 


Model 155-11 


MODEL=155-ll 


6312 


6352 


6352 


6352 


6352 


RMS support 


Model 158 


MODEL=158 


6312 


6352 


6352 


6352 


6352 


RMS support 


STDJC 
















(Standard Job Control 
















Settings) 
















Support of &SYSPARM 


SPARM=YES 


8 


16 


24 


32 


40 


other STDJC options require no storage 


Assembler System 
















Variable Symbol 
















FOPT 
















(Functional Supervisor 
















Options) 
















Abnormal Termination 


AB::::YES 
















without AP=YES 


400 


408 


416 


424 


432 


Forced by VSAM=:YES 




with AP=YES 


N.A. 


554 


554 


554 


554 




Console Buffering 


CBF=n (see Note 5) 




224 H 


H 104n 






Does not apply to Models 115 and 125 


DASD File Protection 


231 1> 
DASDFP=(n1, n2, 22{l 


328 + 2 


4(n2-N1) 












DASDFP=(n1, n2, 2321) 


I 

424 + 24 (n2-n1) 












DASDFP=:(n1, n2, 3330) 


376 + 24 {n2-nlf 












DASDFPz:.(n1, n2, 3340) 


384 + 24 (n2-n1) 










Model 115/125 Display 


DOC=125D 


2816 


2832 


2832 


2832 


2832 


Forced by M0DEL=1 15 and 125 


Operator Console 
Error Queuing 


ERRQ=n 


44(n-3 


44(n-5) 


44(n-5) 


44(n-5) 


44(n-5) 


if default used 


Error Volume Analysis 


EVA=:(r, w) 

















Forces TAPE=7 


Virtual Storage Man- 
agement Support 
Independent Directory 


GETVIS:zzYES 
IDRA=YES 


1152 
N.A. 


1152 
192 


1152 
192 


1152 
192 


1152 
192 


Forced by VSAM=YES; 
Forces RELLDR^YES 

Valid only if NPARTS" 1 


Read/In Area 
Interval Timer 


1T=YES 


456 


888 


896 


920 


928 


If OC=YES, refer to OC, if PCzzYES, ref 
PC 


Job Accounting Inter- 


JA=YES 


512 


704 


832 


880 


1104 




face 


JA=(n1,n2,n3,n4,n5) 


600 + 


792 


920 


1060 


1192 + 


8(n1 + n2 + n3 + n4 + n5) 






8(n1) 


8(n1 + n2) 


8(n1 +n2 + f 


i3) 8(n1 + 


n2 + n3 + n4 






JALIOCS:=(s, 1) 
















(see Note 3) 


Value from JA 
1 


plus (s + 1) - 
1 


16 
1 




■ 
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Supervisor Element 


Generation Operand 


NPARTS=1 


Multiprogramming 


Comments 


NPARTS=2 


NPART$=3 


NPARTS=-4 


NPARTS=5 


FOPT (continuedl 
User Channel Program 
Translation 


ECPREAL- YES 


352 


352 


352 


352 


352 




Problem Program Handling 
of External Interruptions 


OC=YES 
Including 1T=YES 


256 
520 


256 
960 


264 
976 


272 
1008 


280 
1024 


Forcer) by RETAIN YES and OLTEP = YES 




Including IT=YES when 
AP=YES 


NA 


1216 


1224 


1232 


1240 


Does not include any AP storage requirements 




Including IT=YES and 
PC^YES 


568 


1016 


1040 


1080 


1104 




On Line Testing 


OLTEP=YES (default) 


208 


312 


320 


312 


312 


Forces RELLDR=YES and OC=YES 
Forced by RETAIN=YES 


Support of User Program 
Check Routines 


PC=YES 
when AP=:YES 


256 
NA 


256 
384 


264 
334 


272 
384 


280 
384 


Does not include any AP storage requirements 




Including IT=YES 


504 


944 


960 


992 


1008 






Including OC=:YES 


320 


328 


344 


360 


376 






Including IT=:YES when 
AP=YES 


NA 


1320 


1320 


1320 


1320 


Does not include any AP storage requirements 


Private Core Image library 
Support 


PCI L= YES 


192 


216 


232 


256 


272 




Problem Determination 
Programs (PDAiDS) 


PD=n 

PD^YES 


n + 168 

1568 


n + 168 

1568 


n + 168 

1568 


n + 168 

1568 


n + 168 
1568 




Page fixing 


PFIX=YES 


1632 


1944 


1952 


1968 


1976 


Forced by PHO=YES 


Partition Dispatching 
Priority 


PRTY=partition name and sequence 


NA 
















Private Second 
Level Directories 


PSLD=n 


8n 


16n 


24n 


32 n 


40n 




Relocating Loader 


RELLDR=YES 


504 


504 


604 


504 


504 


Forced by GETVIS=YES, OLTEP=YES 
and VSAM=YES 


RETAIN-Remote Initiation 
of OLTEP programs 


RETAIN=YES 


96 


112 


112 


112 


112 


Forces OC^YES and OLTEP=YES 


Seek Separation 


SKSEP=YES, or n (see Note 4) 


150 + 5n 


150 + 5n 


150 + 5n 


150 + 5n 


150 + 5n 




Second Level Directory 


SLD=n 


8n 


8n 


8n 


8n 


8n 




Disk System Input and 
Output Files 


SYSFIL=YES 
SYSFIL=YES(nl,n2) 
(and DASDFP=(n1. n2, 2311) 


664 

24(n2 
952 


792 

-n1) + 

1080 


880 
1176 


968 
1248 


1056 
1336 


Required if TAPE=nO 




(and DASDFP=(n1, n2, 2321) 


1040 


1176 


1264 


1344 


1432 






(and DASDFP=(n1, n2, 3330) 


992 


1128 


1216 


1296 


1384 






(and DASDFP=(n1, n2, 3340) 


7^6 


1136 


1220 


1304 


1392 
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Supervisor Element 


Generation 






Multiprogramming 


Comments 




Operand 


NPARTS= 


=1 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 




FOPT (Cont.) 




















Tape Error Statistics — 


TEB=n 


36 + 6n 




36 + 6n 


36 + 6n 


36+6n 


36 + 6n 






2495 Tape Cartridge 




















Reader 




















Tape Errofc Statistics 


TEBV=IR,orCR 























by Volume 




















Time-of-Day Clock 


TOD=YES 


640 




640 


640 


640 


640 






Support . • • . " 




















Track Hold 


TRKHLD=n 


NA 




568+ 


568+ 


568+ 


568+ 


Valid only is NPARTS > 1 






(see Note 6) 






12n 


12n 


12n 


12n 






VSAM 


VSAM=YES 


384 




400 


408 


392 


392 


Forces AB=YES, GETVIS=YES, and 

HELLDR^ 


YES 


Multiple Wait 


WAITM=YES 


64 




64 


64 


64 


64 


Forced by AP=YES 




Time Zone for Time of 


ZONE=NO' 


















Day Clock Support 


(EAST,hh,mm) 
(WEST,hh,mm) 























PtOCS 


BLKMPX=YES 


48 




40 


40 


40 


40 




(Physical IOCS Support] 




















Burst Mode on Byte 


BMPX = YES 


136 




120 


120 


120 


120 






Multipiexer Channel 




















Channel Switching Tape 


CHANSW=RWTAU; 32 




32 


32 


32 


32 


Forces TAPE=7 




Control 


or TSWTCH 




















DISK-2311,or2314 



















Not valid if M0DEL=115 or 125 






DISK=3330 


672 




672 


672 


672 


S72 


Forced for Model 125 






DISK=3340 


768 




7^ 


/68 


768 


768 


Forced for Model 115 






DiSKrr(3330, 3340 


880 




880 


880 


880 


880 






MICR Device on Selector MRSLCH=YES 


40 




40 


40 


40 


40 






Channel (1419 Single 




















Address Device only) 




















Tape Support 


TAPE=7, 














TAPE=7 is forced by EVA=(r,w) and 






or 9 (default) 


528 




520 


520 


520 


520 


by CHANSW=RWTAU or TSWTCH. For Model 115 


















or 125 CHAN = YES is required. 




VSTAB 


















(Size of Real and Vir- 






1 










tual Address Areas and 






Obtain value from table — 


This is for: 








CCW Translation 






Part 5 of this Figure. 


NPARTS = 


1 720 






space) 


RSIZE=niK ] 






When PHO = YES or 

PFIX = YES,addQ^'-,and 
2 




2 788 








1 






= 


3 856 








VSIZE=n2K 






subtract the number of bytes 
included in basic supervisor 


=S 


4 924 

5 992 








BUFSIZE=n \ 


' 
















(Required) 
(see Note 9) 


72(n-10 


) 


72(n-30) 


72(n-30) 


72(n-30) 


72(n-3Q) 


if default used 






SVA=(nk,mk) 
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o 
c 

H 



<t3 
H 

9 

a 

3 



d 
I 

U1 



c 
a> 
< 

CO 

o 
l-t 

?0 
fD 



CD 
rt 
O 

h( 
OJ 

(D 

?0 
(0 

H 

(D 
3 
(-1- 
W 

I 

I 

to 

^ 
rt 
fl) 
en 



O 

















RSIZE (K bytes) 












VSIZE 


64 


96 


128 


144 


160 


192 


208 240 


256 


384 


512 


768 


1024 


(Kbytes) 
64 


























456 





_ 


_ 


_ 


_ 


_ _ 


_ 


_ 


_ 


_ 


_ 


96 


524 


652 


- 


— 


— 


— 


_ _ 


— 


— 


— 


— 


— 


128 


524 


720 


848 


- 


- 


- 


_ 


- 


- 


_ 


- 


- 


192 


592 


788 


916 


1048 


1112 


1240 


- - 


- 


- 


- 


- 


- 


256 


660 


856 


984 


1116 


1180 


1308 


1440 1568 


1632 


- 


- 


- 


- 


320 


728 


924 


1052 


1184 


1248 


1376 


1508 1636 


1700 


- 


- 


- 


- 


384 


796 


992 


1120 


1252 


1316 


1444 


1576 1704 


1768 


2416 


- 


- 


- 


448 


864 


1060 


1188 


1320 


1384 


1512 


1644 1772 


1836 


2484 


- 


- 


- 


512 


932 


1128 


1256 


1388 


1452 


1580 


1712 1840 


1904 


2552 


3348 


- 


- 


640 


1068 


1264 


1392 


1524 


1588 


1716 


1848 1976 


2040 


2688 


3548 


- 


- 


704 


1136 


1332 


1460 


1592 


1656 


1784 


1916 2044 


2108 


2820 


3616 


- 


- 


768 


1204 


1400 


1528 


1660 


1724 


1852 


1984 2112 


2176 


2888 


3684 


4980 


- 


832 


1272 


1468 


1596 


1728 


1792 


1920 


2116 2244 


2308 


2956 


3752 


5048 


- 


896 


1340 


1536 


1664 


1860 


1924 


2052 


2184 2312 


2376 


3024 


3820 


5116 


- 


960 


1408 


1668 


1796 


1928 


1992 


2120 


2252 2380 


2444 


3092 


3888 


5184 


- 


1024 


1540 


1736 


1864 


1996 


2060 


2188 


2320 2448 


2512 


3160 


3956 


5252 


6548 


1280 


1812 


2008 


2136 


2268 


2332 


2460 


2592 2720 


2784 


3432 


4228 


5524 


6884 


1536 


2084 


2280 


2408 


2540 


2604 


2732 


2864 2992 


3056 


3704 


4500 


5860 


7156 


1792 


2356 


2552 


2680 


2812 


2876 


3004 


3136 3264 


3328 


4040 


4836 


6132 


7428 


2048 


2692 


2888 


3016 


3148 


3212 


3340 


3472 3600 


3664 


4312 


5108 


6404 


7700 


2304 


2964 


3160 


3288 


3420 


3484 


3612 


3744 3872 


3936 


4584 


5380 


6676 


8036 


2560 


3236 


3432 


3560 


3692 


3756 


3884 


4016 4144 


4208 


4856 


5652 


7012 


8308 


2816 


3508 


3704 


3832 


3964 


4028 


4156 


4288 4416 


4480 


5192 


5988 


7284 


8580 


3072 


3844 


4040 


4168 


4300 


4364 


4492 


4624 4752 


4816 


5464 


6260 


7556 


8852 


4096 


4996 


5192 


5320 


5452 


5516 


5644 


5776 5904 


5968 


6616 


7412 


8708 


10004 


5120 


6148 


6344 


6472 


6604 


6668 


6796 


6928 7056 


7120 


7768 


8564 


9860 


11156 


6144 


7300 


7496 


7624 


7756 


7820 


7948 


8080 8208 


8272 


8920 


9716 


11012 


12308 


7178 


8520 


8648 


8844 


8908 


8972 


9168 


9232 9360 


9492 


10140 


10936 


12232 


13592 


8192 


9604 


9800 


9928 


10060 


10124 


10252 


10384 10512 


10576 


11224 


12020 


13316 


14612 


9216 


10756 


10952 


11080 


11212 


11276 


11404 


11536 11664 


11728 


12376 


13172 


14468 


15764 


10240 


11908 


12104 


12232 


12364 


12428 


12556 


12688 12816 


12880 


13528 


15620 


15620 


16916 


11264 


13060 


13256 


13384 


13516 


13580 


13708 


13840 13968 


14032 


14680 


15476 


16772 


18068 


12288 


14212 


14408 


14536 


14668 


14732 


14860 


14992 15120 


15184 


15832 


16628 


17924 


19220 


13312 


15364 


15560 


15688 


15820 


15884 


16012 


16144 16272 


16336 


16984 


17780 


19076 


20372 


14336 


16516 


16712 


16840 


16972 


17036 


17164 


17296 17424 


17488 


18136 


18932 


20228 


21524 


15360 


17668 


17864 


17992 


18124 


18188 


18316 


18448 18576 


18640 


19288 


20084 


21380 


22676 


16384 


18820 


19016 


19144 


19276 


19340 


19468 


19600 19728 


39792 


20440 


21236 


22532 


23828 



3 

>n 

H 

o 
o 

(0 

c 

H 

a> 

CO 



Supervisor Element 


Generation 
Operand 




Multiprogramming 


Comments 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


lOTAB 
















(Input/Output Tables) 
















Number of programmer 


BGPGR=n 


2(n-10) 


2(n-10) 


2(n-10) 


2(n-10) 


2(n-10) 




logical units 


F4PGR=n 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 






F3PGR=n 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 






F2PGR=n 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 


2(n-5) 


>0 if default used 




F1PGR=n 


2(n-5) 


2(n-5) 


2{n-5) 


2(n-5) 


2(n-5) 


I 


Number of Channel 
Queue Entries 


CHANQ=n 
(see Note 5) 


8(n-6) 


8(n-6) 


8{n-6) 


8{n-8) 


8(n-10) 


' 


Amount of Extra Space 


D2311=n1 


I2n1 


24n1 


24ri1 


24n1 


24n1 


\ 


reserved for the PUB 


D2314=n2 


12n2 


24n2 


24n2 


24n2 


24n2 


IForModelsllSor 125, 


Table (required for 


D2321=n3 


12n3 


24n3 


24n3 


24n3 


24n3 


Ithese parameters are ignored if both 


RMSR recording) 


D3330=n4 


20n4 


32 n4 


32n4 


32n4 


32n4 


1 CHAN=NO and RMS=NO in the SUPVR 




D3340=n5 


4n5 


16n5 


16n5 


16n5 


16n5 


V macro, or if both these parameters 




D2400=n6 


48n6 


60n6 


60n6 


60n6 


60n6 


/are omitted and, therefore, default 




D3410=n7 


56n7 


68n7 


68n7 


68n7 


68n7 


I to No. 




D3420=n8 


56n8 


68n8 


68n8 


68 n8 


68n7 


I 




D3540=n9 


4n9 


16n9 


16n9 


16n9 


16n9 


1 




D3836=:n10 


14n10 


26n10 


26n10 


26n10 


26n10 


/ 


Number of I/O 
devices on system 


(see Note 8) 
IODEV=n 




n/r» 


1 n\ 






For Models 115 and 125 without 
CHAN or RMS. if default used 
for Model 135 and upward and 
for Model 1 15 or 125 with CHAN 




0(n lu; 












1 l/U + -cf 






















or RMS 


Number of Job Inform- 


JIB=:N 


4(n-5) 


4(n-5) 


4(n-5) 


4(n-5) 


4(n-5) 




ation Blocks 
















Number of Start/Stop 


SSLNS=n1, 
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► 




BSC Lines (Model 125 
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ICA Only) 

















Figure 1-5. Supervisor Real Storage Requirements — Bytes (Part 6 of 8) 
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Note 1. A 1255/1259/1270 is addressed as a single address 
adapter machine, i.e. i\/IICR=1419. 

Note 2. NPARTS=2-5 is required for TP=QTAIVIn. TP=QTAIVIn 
includes BTAM supervisor support. 
If AP=YES when TP=QTAMn, then the quantity A must 
be added to the basic storage requirement for TP=QTAMn . 
A=44+ (n— 2) 12, where n is the value elected for 
TP=QTAMn . (For multitasking, AP must equal YES.) 

Note 3. If s is omitted or if its specification is invalid, 

then 16 bytes are reserved. If 1 is omitted or if it 
is invalid, is assumed. 

Note 4. When SKSEP=YES, n (in the formula) equals the number 
of DASD devices specified at system generation time. 
When SKSEP=n, n (in the formula) is the number of 
DASD devices supported as specified, but cannot be 
less than the number specified at system generation 
time. 

Note 5. The selection of the CBF option results in extra 

channel queue usage. Consider this when requesting 
the number of CHANQ entries. Thus, specification of 
the CBF option and selection of the CHANQ default, 
results in the number of buffers specified being added 
to the CHANQ default, for which see below. 

CHANQ default=6 if NPARTS=3 
CHANQ default=8 if NPARTS=4 
CHANQ default=10 if NPARTS=5 

Only is the number of queue entries as specified by 
the CBF parameter plus the CHANQ default is larger 
than the number of entries actua]iy_ specified by the 
CHANQ parameter, add 8n2, where n2=CHANQ default + 
CBF specification — CHANQ specification (zero for 
negative). 

example 1: CHANQ=3b 
CBF=4 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF:216+104x4+8xO 
(n2=0 because CBF (4) + CHANQ default (8) is less than 
30 (CHANQ specification) 

example 2: CHANQ=10 
CBF=4 
NPARTS=4 (CHANQ default is 8) 

Number of bytes reserved for CBF:216+104x4+8x2 

(n2=2 because CBF (4) + CHANQ default (8) minus CHANQ (10)=2). 



Figure 1-5. Supervisor Real Storage Requireirents--Bytes (Part 7 of 8) 
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Note 6. Where n equals the maximum number of tracks 
(1—255) to be held at any given time by the 
entire system. The default is 10 if n is an 
invalid parameter (non-numeric or outside the 
range, 1-255). 

Note 7. When M0DEL=1 15 or 125 is specified, program support 
for the Display Operator Console is generated. 

Note 8. In addition to the total number of bytes 

reserved for the tape and disk devices spec- 
ified, an extra amount is reserved of 12B bytes, 
where B=the number of devices specified by the 
lODEV parameter minus the total number of devices 
specified by the Dxxxx parameters. 
(B=n— (n^ -H n2 + n3 -f n4 -f- ng -t- ng + ny + ng). 
The minimum value of B is 5, because of the fact 
that if the total number of devices specified by 
the Dxxxx parameters exceeds the number of devices 
specified by the lODEV parameter, the latter 
number is upgraded to 5 more (for unit record 
devices) than the number of devices specified by 
the Dxxxx parameters. 

Note 9. Since the table (Part 5 of this figure) does not 
contain all possible VSIZE values, you may use 
the nearest larger value without significant error. 
The exact formula for calculating real storage 
requirements is as follows, where RSIZE=n1k 
and VSIZE=n2k: 

4 X n1 + 68 X [CEI L Ill-±J32 j + 64 [CEI L ( i x CEI L( Q-L+H?. )) j 
64 16 64 

+ 148* 

* Add 148 only if RSIZE > 384K, otherwise -I- 

For CEIL, in the formula, substitute the quotient of 

————— ; fractions to be rounded off to the next higher 
64 

integer. 



Figure 1-5. Supervisor Real Storage Requirements--Bytes (Part 8 of 8) 
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Supervisor Real Storage Requirements 

This section contains the data for estimating the size of the supervisor 
required for a generated systeiri, that is, the amount of real storage 
needed at object time for the supervisor macro instructions. 

The supervisor varies in size frow systeir tc systeir depending or the 
user-selected options and the machine configuration. All supervisor 
generation options are described earlier in this module under "The 
Supervisor Generation Macros". 

The size of the supervisor is a determining factor for the amount o^ 
real storage available for probleir program, use. All real storage not 
allocated to the supervisor is available for use by programs running in 
virtual mode (the main page pool) and in real mode via specification of 
real partitions. For more details on the allocation of real partitions 
refer to the description of the ALLOCR macro instruction. 

Figure 1-5 gives the real storage requirements for your supervisor, 
the size of which is determined by the options you specify (including 
default specifications) in the supervisor generation macro instructions. 
The basic supervisor (see sizes on the first line of data of Figure 1-5) 
is dependent on the number of partitions you require (SUFVR macro 
NPARTS=) ; however, it is independent of any other supervisor generation 
options. 

To this basic size you must add the storage requirements for each 
selected option (see column "Generation Operand"). You must be careful 
to include the values for any opticns you have selected by default. 

You must also include the storage requirements for any option you did 
not specify but which is forced by another option you did specify (see 
Figure 1-3 showing which options are forced or required). Thus, for 
example, the SUPVR macro operand for Page Exception Handling Overlap 
(PHO=YES) forces the FCPT macro operand PFIX=YES for page fixing. 
Therefore, if you specify PHG=YES, you must include the storage 
requirements of both PHO=YES and PFIX=YES. 

The comments column of Figure 1-5 indicates when one option forces 
another option or is forced by another option. Certain options share 
common code and thus the mixture rather than the individual values must 
be considered in obtaining the total storage requirement. Thus, for 
example, the FCPT macro options I'I=YES, PC=YES, and OC=YES share common 
code. Figure 1-5 provides for this by stating storage requiremients for 
each option separately and in all combinations. If you have selected 
more than one of these options, select the combined requirement frcm the 
row which includes your combination. 

The SEND macro instruction allows you to reserve additional storage 
for your supervisor. Refer to the description of the SEND macro 
instruction for further details. 

Because of storage protection, the supervisor must always end on a 2K 
storage boundary. Supervisor generation always causes the total 
generated supervisor size to be rounded up to the nearest 2K bouhdary. 
Thus, a calculated supervisor end address of, say, 31,120 bytes, is 
rounded to 32K (32,768 bytes). 

Some supervisor macro instructions do not affect your storage 
requirements because they merely supply information to be placed in 
storage occupied by other macro instructions. These macro instructions 
are not included in Figure 1-5. They are: 
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STDJC (all operands except SPARiyi=YES) 

ALLOC 

ALLOCR 

DVCGEN 

ASSGN 

DPD 

In summary, to calculate the size of your supervisor, add the values 
as indicated in Figure 1-5 for: 

- Your base (deteririned by NPARTS=) 

- The storage requirements for all options you specifically selected 

- The storage requirements for those options you did not specify but 
that default to YES 

- Storage requirements for all options you selected indirectly, that 
is options that were forced by other, specified, options 

- Any additional storage you reserved via the SEND iracro 
instruction. 
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Computing the Size of a Supervisor 

hs an example, assume a supervisor is generated using the macros shown 
in Figure 1-6. The size of this supervisor is deteririned as follovvs: 

GENERATION OPERAND REAL STORAGE 

REQUIREMENT (fcytes) 

SUPVR 

NPARTS=a 27, 544 

POWER=YES. 312 

PHO=YES 672 

TP=BTAM 544 

CONFG 

MODEL=135. 5,480 

FP=YES 72 

STDJC , 

FOPT 

RELLDR=YES 504 

VSAM=YES 392 

IT=YES 

OC=YES 1,080 

PC=YES 

SKSEP=YES 16 

PCIL=YES 256 

PFIX=YES 1,968 

CBF=10 1,264 

TRKHLD=10 ^ 688 

SYSFIL=YES ) 

DASDFP=(1,1,3330)( 1,296 

TOD=YES 640 

Z0NE=(WEST,5) 

GETVIS=YES 1,152 

OLTEP=YES. . 312 

AB=YES 424 

PIOCS 

DISK=3330 672 

TAPE=7 520 

VSTAB 

RSIZE=240K 96 8 

VSIZE=426K 

BUFSIZE=48 1,296 

ALLOC 

ALLOCR , 

lOTAB 

BGPGR=20 20 

F1PGR=10 10 

F2PGR=10 , 10 

F3PGR=10.. 10 

IQDEV=15. 220 

JIB=45 160 

D3330=2 64 

D3410=4 272 

CHANQ=32 192 

Total Number of Bytes 49,174 

Note; If entry for BGPGR is below minimum requirement, n=10 is assumed. 
The following MNOTE is obtained for an entry of less than 10. 

BGPGR SPECIFICATION BELOW MINIMUM - "10" ASSUMED 
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// JOB SUPVR 

// EXEC ASSEMBLY 

SUPVR NPARTS=4 , POWER=YES ,PHO=YES ,TP=ETAM 

CONFG MODEL=135,FP=YES 

STDJC LISTX=YES , LINES=4 6 , EDECK=YES 

FOPT RELLDR=YES , IT=YES , VSAM=YES , OC=YES , PC=YES , 

SKSEP=YES , PCIL=YES , CBF=1 0, TRKHLD=10 , SYSFIL=YES , 

DASDFP= (1, 1, 3330) ,TOD=YES, ZONE= (WEST, 5) ,PFIX=YES, 

AB=YES , OLTEP=YES 
PIOCS DISK=3330,TAPE=7 

VSTAB RSIZE=240K, VSIZE=426K, BUFSIZE=48 
ALLOC Fl=128K,F2=6tlK,F3=128K 
ALLOCR BGR=60K,F1R=30K,F2R=30K 
lOTAB BGPGR=20 , FlPGR=10 , F2PGR=10 , F3PGR=10, I0DEV=15 , JIB=45, 

CHANQ=32,D3330=2,D3410=4 
DVCGEN CHUN=X*00C*,DVCTYP=2540R 



END 
/♦ 
/g 



DVCGEN CHUN=X*OOD* 
DVCGEN CHUN=X«OOE' 
DVCGEN CHUN=X*01F' 
DVCGEN CHUN=X»020' 
DVCGEN CHUN=X»021' 
DVCGEN CHUN=X*022' 
DVCGEN CHUN=X'023' 
DVCGEN CHUN=X*02'4« 
DVCGEN CHUN=X*160* 
DVCGEN CHUN=X'161» 
DVCGEN CHON=X*280* 
DVCGEN CHUN=X'281* 
DVCGEN CHUN=X'282' 
DVCGEN CHUN=X*28 3' 
ASSGN SYSRDR,X'OOC 
ASSGN SYSIPT,X'OOC 
ASSGN SYSPCH,X'OOD 
ASSGN SYSLST,X' OOE 
ASSGN SYSLOG,X'01F 
ASSGN SYSLNK,X'160 
ASSGN SYS001,X'160 
ASSGN SYS002,X«160 
ASSGN SYS003,X'160 
ASSGN SYSREC,X'160 
ASSGN SYSCAT,X'161 
DPD CYL=200,UNIT=X 
SEND 



DVCTYP=2540P 

DVCTYP=3211 

DVCTYP=1050A 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=2703 

DVCTYP=27 03 

DVCTyF=27Q3 

DVCTYP=3330 

DVCTYP=3330 

DVCTYP=3tH0T7 

DVCTYP=3mOT7 

DVCTYP=3t»10T9 

DVCTYP=3410T9 



160' ,V0LID=111111 



Figure 1-6. SUPERVISOR — Exairple fcr Ccmputing the Size cf a Supervisor 
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Planning an Operational Pack 



An cperational system is one used in day-to-day operations and contains 
one or more tailored supervisors, and libraries appropriate to each 
customer's particular combination of systeir prcgrairs and application 
programs. A system maintenance voluirie is one used priirarily to 
facilitate changes to prograirs supplied by IBM. Application programs 
can also be added to a maintenance volume for ease of prcgrair 
maintenance. 

Chan ge Distributions are those changes supplied by IBM to the 
IBM-shipped volume. 

Proper planning is the key tc successful system generations. The 
time spent in planning can save you frustration and valuable time. 
Planning should reflect the initial, intermediate and ultimate capacity 
of the core image, relocatable, source statement, and procedure 
libraries. Enough workfile capacity must be available throughout systeir 
generation for assemblies and link-edit steps. 

The module for each component should be used tc determine its storage 
requirements. Figure 1-18 contains a summary of the library and 
partition requirements for all components shipped with DCS/VS. Adjust 
the requirements you derived frcm this figure fcr any program products 
(separately purchased components) you are including. Please also note 
that any Program Products supplied in A-macrc format must be edited. 
The IBM-supplied system contains a 32K supervisor for the 2314/2319, 
3330, and 3340 resident systems. This supervisor is described further 
in "Supervisor Nucleus — 5745-SC-SUP" . 



STORAGE REQUIREMENTS FOR IBM-SUPPLIED DOS/VS PROGRAMS 

Note that the partition save area is located at the beginning of each 
partition, thus reducing the partition size by the length of the save 
area. 



Organization of a DOS/VS System Pack 



The organization of the system pack is as fcllcws: 



Name 

IPL Program 

System Volume Label 

System Directory 

Librarian Work Area 

Transient Directory 

Open Routine Directory 

Library Routine Directory 

Foreground Program Directory 

Problem Program Phase 
Directory 



Start of Location 

Track of Cylinder 0. 

Track of Cylinder 0. 

Track 1 of Cylinder 0. 

Tracks 2, 3, and U of Cylinder 0. 

Track 5 of Cylinder 0. 

Track 6 of Cylinder 0. 

Track 7 of Cylinder 0. 

Track 8 of Cylinder 0. 

Track 9 of Cylinder 0. 
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I Core Image Directory 
Core Image Library 



Relocatable Directory, 
Optional 



Relocatable Library, 
Optional 



Source statement 
Directory, Optional 



Source Statement Library, 
Optional 



Procedure Directory, 
Optional 



Procedure Library, 
Optional 



Label cylinder 



Volume Table of contents 



Track 10 of cylinder on a 
2314/2319, 3330, or 3340. 

Beginning of the first available 
track fcllovving the cere image 
directory. 

Track of the first available 
cylinder following the core image 
library. 

Beginning of the first available 
track following the relocatable 
directory. 

Track of the first available 
cylinder following the previous 
library. 

Beginning of the first available 
track following the source statement 
directory. 

Track cf the first available 
cylinder following the previous 
library. 

Beginning of the first available 
track following the procedure 
directory. 

First full cylinder after the last 
system library. 

Location assigned by the user. 

Note ; The IPL procedure cannot be 
perfcrined if either: 

• the Transient Directory is located en a 
defective track while an alternate 
track has been assigned, or 

• part of the Supervisor Nucleus in the 
cere image library is located en an 
alternate track. 

This is caused by the fact that the IPL 
bootstrap prograrr does not contain any 
error recovery routines. Restrictions 
that had to be irrposed on the size of this 
program did net allow the inclusion cf any 
such routines. 
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Track 



H-+ 



Background User 
Labels 



Background User 
Labels 



Background User 
Labels 



Background User 
labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



Background Par- 
tition Standard 
(PARSTD) Labels 



I— + 



-^ 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 4 
User Labels 



I— + 



Foreground 1 
Partition Stan- 
dard Labels 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



Foreground 4 
Partition Stan- 
dard Labels 



I— + 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 3 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 3 
Partition Stan- 
dard Labels 



Foreground 1 
User Labels 



Foreground 2 
User Labels 



Foreground 1 
Partition Stan- 
dard Labels 



Foreground 2 
Partition Stan- 
dard Labels 



Foreground 1 
User Labels 



Standard 
Labels 



Standard 
Labels 



Foreground 1 
Partition Stan- 
dard Labels 



10 



19 

L X 



Standard 
Labels 



Standard 
Labels 



2-Partition 
System 



3-Partition 
System 



4-Partition 
System 



5-Partition 
Sy Steffi 



Figure 1-7. Label Cylinder Track Allocations for 2314/2319 

Disk-Resident Systems 
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Allocating Library Sizes 

When the size of an existing library is reduced, it iray fce important to 
know the minimum size library that can be allocated. Once the itiiniitiuni 
size library is calculated, it should be increased to accomrcdate any 
problem programs to be included in the library. The size of IBM 
components can be determined by referring to the storage requirements 
given in Figure 1-17 and to appropriate documentation for any program 
products to be included. 

The following explanation illustrates how tc calculate the number of 
tracks required for a core image, relocatable, source statement, or 
procedure library. The formula fcr computing the size of a library is: 

Library (size in tracks) = LEA/nn 

where: library = either core image, relocatable, source statement, or 

procedure 

LBA = the number of LIBRARY BLOCKS ACTIVE for the library of 
interest and is obtained from a CIRECTCRY (SYSTEM cr 
PRIVATE) 

nn - LIBRARY LAST AVAILABLE ENTRY in the R (record) column 

Using the sample STATUS REPORT that follows, an example cf how to 
compute a library size is: 

Relocatable Library = LBA/nn 

where: LBA = 11,957 

nn = 16, thus 
Relocatable Library = 11,957 = 747.5 tracks 

16 

The relocatable library size computed does net include the tracks 
allocated for the directory. The directory size must be added to the 
relocatable library size computed. Thus, 

Relocatable Library Allocation = Relocatable Library + Directory 
Allocated Tracks 

Therefore, 

Relocatable Library Allocation = 747.5+10 

= 757.5 Tracks 

For a 2314, cylinders = Library Size (Tracks) 

20 

For a 3330, cylinders = Library Size (Tracks ) 

19 

For a 3340, cylinders = Library Size (Tracks) 

12 

For this example, 

the Relocatable Library Allocation for a 3 330 = 757.5 Tracks 

19 
= 39.9 or 40 cylinders, rounded high 
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STATUS REPORT STARTING NEXT 

time; 17.31 ADDRESS ENTRY 

date: 10/08/73 C H R C H R E 



LAST DIRECTORY LIBRARY BLOCKS 

ENTRY ENTRIES 

H R E ACTIVE ALLOCTD ACTIVE DELETD AVAIL 



AUTO. DIR. TRACKS 
COND. OR LIBRARY 
LIMIT CYLINDERS 



SYSRES VOL.SER.R29RES 

CORE IMAGE DIRECTORY 000 02 01 000 10 Ok 000 11 17 

LIBRARY 000 12 01 043 18 06 05't 19 06 



1402 



6528 5201 



1327 



10 
55 



SYSRES VOL.SER.R29RES 
RELOCATABLE DIRECTORY 
LIBRARY 



055 00 01 055 04 07 02 055 09 17 19 1477 

055 10 01 092 17 06 096 19 16 13280 11957 



1323 



10 
42 



SYSRES VOL.SER.R29RES 
SOURCE-STMT DIRECTORY 
LIBRARY 



097 00 01 097 01 24 05 097 09 27 09 
097 10 01 195 07 19 196 19 27 



500 



53730 52857 



873 



10 
100 



SYSRES VOL.SER.R29RES 
PROCEDURE DIRECTORY 
LIBRARY 



197 00 01 197 00 03 09 197 04 27 09 
197 05 01 197 1 1 38 197 19 40 



24 



595 



272 



323 



SYSTEM DIRECTORY AND LIBRARY TRACK CAPACITIES 



Figures 1-8 and 1-9 illustrate the DOS/VS system library directory and track capacities, 

' 1 

Directory Entries Per Track | 



r 

I 

r + 

Device 



T T T 

Core Image | Relocatable | Source j Procedure 
Library | Library j Statement | Library 
(Phases) j (Modules) j Library (Books) | (Procedures) 

2311 I 135 I N.A. I N.A. | N.A. 



I 



2314/ 
2319 
Y + 



3330 



3340 



270 



340 



270 



270 



468 I 560 I 440 | 440 

4 + + ^ 



288 



340 



260 



260 



Figure 1-8. LIBRARIES — System Library Directory Capacities (Entries 
per Track) 
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Core Image 
Library 



r T T T T 

I Device 123111 23m/| 33301 3340 

I I I 23191 I 

I Library | | | | 

iBlock |1024| 1024|1024|102U 

I Size (bytes) I | | | 
h 



Relocatable 
Library 



T T 

Source Statement Procedure 



Library | 



Library 



T T r T T i 

2314/1333013340 | 2314/ | 3330 | 33 40 

23191 I I 23191 I 
^ ^ 1 1 1 ^ 



2314/J3330J3340 

23191 I 
+ + 

I I 
322| 322| 322 

I I 



160| 160| 160| 80| 80| 80 
I I i I I 



[Blocks per | 3| 
j Track | I 

L X i. 



6| 111 



16| 28| 17 



27| 44| 261 40| 61| 34 

I I I I i 
L X L J. ^X 



Figure 1-9. LIBRARIES — System Library Track Capacities 
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THE PAGE DATA SET 



SYSVIS is the logical unit name of the data set that holds the virtual 
address area. It is created at IPL time from information provided by the 
system generation macro DPD and/or the IPL DPD command. The user specifies 
the beginning cylinder address and the system calculates the size of the 
disk extent which is a function of the VSIZE specification and the disk 
device type, as follows: 

VSIZE = number of pages (blocks of 2K bytes) 
2 



r -^ r T 

I Disk Device Type | Blocks per Cylinder | 



II. 



2314 



3330 



3340 



60 



114 



-^ 



36 



The allocation requires full cylinders. 

The IBM-supplied supervisor does not contain any DPD macro parameters, 
Therefore, when you IPL, you must enter all operands of the DPD command, 
including TYPE=F. The IBM-supplied supervisor has a VSIZE of 64K and 
consequently one cylinder on a 2314, 3330, or 3340 is required. 



RECORDER FILE (SYSREC) 



IJSYSRC is the filename of the recorder file that is used exclusively for 
output from the Recovery Management Support Recorder (RMSR) function. The 
data contained on IJSYSRC is edited and printed by the EREP program. The 
recorder file must be defined, using the file definition statements of the 
system after the first IPL procedure has been performed following 
supervisor replacement but before the firs t JOB card is read. The file is 
created after job control has read this JOE card. 
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The RMSR function makes several types of recordings on the recorder 
file, in chronological order. The file is trade up of records that contain 
information relating to: 

MCAR 

CCH 

Unit Check 

Counter Overflow 

Tape Volume Statistics 

IPL/EOD 

Miscellaneous Data Recorder (2715 error records, 3211 buffer error 

records, 3330/3340 non unit-check records) 

The IJSYSRC file is dei^ined as a disk extent fcr an IBM 2314/2319, 3330, or 
33U0 disk device, and cannot be a split cylinder file. The file should not 
be defined on an extent which includes a defective or alternate track, 
because data may be lost. The file definition must be included in the 
standard label area. 

CREATING ?^ND USING THE RECORDER FILE 

A minimum of ten tracks is required for the recorder file (SYSREC) . The 
following file definition statements create the recorder file: 

// OPTION STDLABEL 

// DLBL IJSYSRC, 'DOS/VS RECORDER FILE' Note; The cards must be 

// EXTENT SYSREC,,,, ,nnnnn,nnnnn included in the 



standard label deck. 



/♦ 

ASSGN SYSREC, X'cuu' 
SET RF=CREATE 



// JOB FIRST 



The recorder file is created when the first job statement (// JOE FIRST) is 
read. 

These file definition statements must immediately follow the IPL 
procedure and precede the first jcb. We recommend that the file definition 
be permanently retained on the standard label track of the label cylinder. 
Thus, once the file is created, recording can proceed at the beginning of 
each day without operator intervention; that is, at IPL time the recorder 
file is opened and updating continues. When the system is to be shut down 
at the end of the day, issue the Record On Demand (ROD) com.mand to record 
the statistical data and to ensure that no statistical data is lost. With 
RDE support, an EOD (End of Day) record is alsc written. 

Note: The ROD command is not valid for recording teleprocessing 
statistical data. Refer to D OS/VS BTAM, GC27-6989, for teleprocessing 
procedures, 

HARD-COPY FILE (MODELS 115 AND 125 ONLY) 

IJSYSCN is the filename of the recorder file that is used exclusively for 
output of information from the message area of the Model 125 Integrated 
Display Operator Console. The symbolic device address of the hard-copy 
file is SYSREC. 



Module 1: Planning and Procedures 77 



The IJSYSCN file must be defined as a disk extent for an IBM 3330 or IBM 
3340 disk device, and cannot be a split-cylinder file. It is to be created 
after the supervisor has been link-edited and cataloged. The following 
file definition statements create the hard-ccpy file: 

ASSGN SYSRECX'CUU' 

SET HC=CREATE 
// OPTION STDLABEL 

// DLBL IJSYSCN, 'DOS/VS HARD COPY FILE' 
// EXTENT SYSREC, , , ,nnnnn,nnnnn 

/* 

// JOB FIRST 



The hard-copy file is created and opened when the first job statement (// 
JOB FIRST) is read. 

The IPL commands that precede the first // JOB statement are not copied 
After the file has been apened, the next available and last available 
records are determined and the standard IPL message DOS IPL COMPLETE is 
written to the hard-copy file. 

When a new hard-copy file is created at IPL time, the records of the 
existing file are destroyed. 



System Generation and Maintenance Procedures 

Many techniques exist for generating and maintaining operational volumes. 
Each installation uses techniques dependent on its machine configuration 
and its selection of system and application programs. The techniques 
described here correspond to the following principal machine configurations 
relevant to system generation and maintenance: 



I ^- 



1. One 231U/2319 direct access storage facility 
One 3330 or 3340 disk storage. 



The two examples given do net show the coding necessary to link-edit and 
delete all lEM-supplied components. They are meant onl^ to be exairples and 
must be tailored to meet your needs. Additional control statements 
required for linkage editing and deleting any lEM-supplied components are 
given in their respective sections. 



DOS/VS System Distributions 

Figure 1-10 illustrates the various distributions of DCS/VS. The 
procedures within this section ("System Generation and Maintenance 
Procedures") will guide you through your system generation. 

Note: The label and extent information for disk distributions is found in 
Section 7 of the "Memorandum to Users" . 

The IBM Disk Operating System/Virtual Storage is supplied on one SYSRES 
file. This file contains the core image library, the relocatable library, 
and the source statement library. 
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SYSTEMS WITHOUT TAPE 



IBM 2314-Onl' 



I 



IBM 2314-onlY users receive the system on one 2316 disk pack. This pack is 
ready for your system generation procedure, but it is recommended that this 
pack be copied and retained for back-up. 

IBM 3330-Only (and 3333-Only) Users 

IBM 3330-only users receive the system on one 3336 disk pack. This pack is 
ready for your system generation procedure, but it is recomm.ended that this 
pack be copied and retained for back-up. 

IBM 3340-Onlv Users 

IBM 3340-only users receive the system on a 3348 data m.odule. This module 
is ready for your system generation procedure, but it is recommended that 
you copy the module and retain it for back-up. 



TAPE USERS 

The system is shipped on a reel of magnetic tape. The tape contains the 
entire SYSRES file and can be restored to a 2316, a 3336, or a 3348 disk 
volume. See "Restoring the IBM-Supplied System Tape to Disk" for the 
procedure to restore this tape. After the tape has been restored, retain 
it for back-up. 



General System Generation Procedures 

Each system generation job begins with a new IPL procedure, followed by the 
necessary DEL, ADD, SET, DPD, and ASSGN commands. Typically, each job 
consists of many job steps, including such programs as: 

• CSERV (core image library service) to punch out (or write on magnetic 
tape, disk, or diskette) prograirs from the core image library. 



• SSERV (source statement library service) to punch out (or write on 
I magnetic tape, disk, or diskette) rriacro definitions. 

• RSERV (relocatable library service) to punch out (or write on magnetic 
I tape,, disk, or diskette) the relocatable modules used to build 

IBM-supplied processor programs. 

• PSERV (procedure library service) tc display en SYSLST or to' punch cut 
(or write on magnetic tape, disk, or diskette) procedures from the 

procedure library. 

• DSERV (directory service) to display on SYSLST the current contents cf 
one or more library directories and their remaining library capacities. 
The directory display may be either an alphabetically sorted listing cr 
a listing of the entries in the order they appear in the directory. 
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• LSERV (label cylinder display) to display (en SYSLST) the label cylinder 
located on SYSRES. SYSLST rray be assigned to disk, tape, or printer. 

• ESERV (de-editor prograrr) to de-edit pre-edited macros from the 
E-sublibrary. It provides SYSLST and SYSFCH output of the original 
macros. It also provides an update facility for one rracro per job step. 

• MAINT (library maintenance) to delete and/or catalog library elements, 
and also to condense and reallocate library extents. 

• CORGZ (copy or merge) to selectively copy or merge library entries from 
one disk pack to another disk pack. CORGZ allows larger or smaller 
allocations for each library of the new pack. 
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Figure 1-10. PROCEDURES — DOS/VS System Distributions 
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The sequence of job steps depends en the configuration available and the 
operational packs being built. Certain activities are ccmmon: 

1. The general systeir generation procedure is: 

a. Initialize the disk pack that is to contain the system. 

b. For disk and tape, restore the IBM-supplied tape onto disk. For 
two disk drives and no tape drives, copy the lEM-supplied systeir 
to another disk to obtain back-up. 

c. Perform the IPL procedure from the restored disk and create the 
Page Data Set, the Recorder File and, if your CPU is a Model 115 
or 12 5, the DOC Hard-Copy File. 

d. Create private libraries, if desired. 

e. Delete unwanted programs from the system (all libraries). 

f. Reallocate library sizes, if required. 

g. Set standard labels fcr system files and work files. 

h. Assemble supervisor into cards. 

i. Linkage edit and catalog supervisor and IBM components. (A 

supervisor cataloged to a private core image library can never be 

used because the IPL retrieval program searches only the system 
core image directory fcr phases beginning with $$.) 

j. Assemble IOCS modules. 

k. Catalog IOCS modules to the relocatable library. 

1. Delete supervisor and IOCS macros if not required. 

m. Perform Installation Verification Procedures. 

2. The supervisor generation macro instructions must be keypunched to 
form a single source deck. 

3. DELETR cards are selected or prepared for each relocatable library 
component that is not needed in the system. On a system with at least 
two disk drives, you can copy selectively rather than delete (DELETR). 
To copy selectively, prepare the librarian cards in the form.: COPYR 
XXX. ALL. 

4. DELETS E.xxxxxxxx cards are selected or prepared fcr each macro 
definition that is not needed in the system. IBM-supplied macrc 
definitions appear in each component section. They appear in the 
general Index under "macros, IBM-supplied" with pointers to the 
correct module number (s). Certain low-usage macro definitions, such 
as supervisor generation macros, may be retained on a system 
maintenance pack, rather than on the operational pack. The becks, 
Z.DELETECL, Z.DELETERL, Z.DELETESL and Z.LINKEDIT, can be retrieved 
through SSERV. These books contain the necessary statem,ents to delete 
or link-edit selectively any components from the system. A pause card 
is read immediately before a deletion or link-edit job is performed. 
This allows you to press the END or ENTER key to perform the job or to 
type in CANCEL at the ccnsele printer keyboard to bypass that deletion 
or link-editing. 

5. After a component is link-edited into the core image library, the 
relocatable library space used to build the component can be freed by 
deleting the modules and condensing the library. The delete book 
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Z.DELETERL can be used to perform this step. Prior to updating a 
component, however, the relocatable library of the pack must be 
rebuilt, by entering the appropriate modules either from cards, 
magnetic tape, or disk. On a system without iragnetic tape this 
tradeoff must be carefully considered: disk tracks made available 
vs. speed and simplicity of ccmponent rraintenance. 

6. To use some compilers a certain collection of IOCS irodules must be 
available in the relocatable library of each operational pack. These 
modules are preassembled and supplied in the relocatable library for 
the compilers that use them. Certain of these IOCS modules are 
link-edited into each ccmpiler object program. These modules are 
generated using the following macro definitions supplied by lEM: 

CDMOD Card Reader/Punch - 3 881 Optical Mark Reader 

PRMOD Printer 

MTMOD Magnetic Tape 

SDMODxx Sequential DASD. SDMOD consists of ten similar macro 
definitions: SDMODFI for sequential disk with fixed 
input, SDMODFO for sequential disk with fixed output, etc. 
A complete description of SDMODxx is contained in DQS/VS 
Supervis or and I/O Macros , GC33-5373. 

ISMOD Index Sequential Access Method, DASD 

DAMOD Direct Access Method, DASD 

DIMOD Device Independent Module 

With assembler language you can assemble these IOCS functions directly 
into their application programs, or the IOCS modules can be assembled 
separately and cataloged intc the relocatable library. Separate 
assembly of IOCS modules requires no additional real storage or 
additional execution overhead in speed. Those modules, shipped 
preassembled for IBM components, can also be used by any other 
program, if applicable. A separate assembly is preferable because: 

• Program assembly and reassembly time is minimized. 

• IBM supplied IOCS modules used by compilers may also be used by 
your application programs. Use of these modules reduces the 
assembly time of your application programs. 

• Use of preassembled IOCS modules facilitates program maintenance 
and standardization. 

• The xxMOD macro definitions just cited require a substantial number 
of cylinders in the source statement library. 

The corresponding generated modules ordinarily require fewer cylinders 
in the relocatable library. Thus, you may prefer to retain xxMOD 
macro definitions only on the system backup volume, cataloging a 
selection of generated modules onto each operational volume. 

7. During each system generation and maintenance procedure, system 
libraries should be copied periodically on magnetic-tape reels, disks, 
or cards to provide backup in case of subsequent specification errors 
or machine errors. 

8. Perform a DSERV, or check a system directory printout to determine the 
contents and sizes of the system libraries during system generation. 
This procedure enables you to determine that enough blocks remain for 
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link-edit and catalog procedures. A DSERV requires the following 
control statements: 

// JOB DSERV 
// EXEC DSERV 

DSPIYS ALL 
/♦ 
/6 

A printout of the library status is provided automatically following a 
linkage edit with an OPTION CATAL specified or any // EXEC MAINT. 

9. The initial system volume from IBM contains the volume serial number 
111111. If the IBM-supplied volume is a tape, initialize the disk 
pack with the volume serial number before restoring the tape to the 
disk. The standard labels (ELBL and EXTENT statements) shown for the 
examples are adequate for system generation. The EXTENT statement, 
however, must be adjusted to reflect your volume serial number. 

To use the standard labels fcr configurations with two disks, SYSLNK, 
SYSOOl, SYS002, and SYS003 can be assigned to the second disk. The 
standard labels shown in the following discussions assume the VTOC to 
be on cylinder 199 of the residence volume (fcr a 2314/2319) , on 
cylinder 403 (for a 3330), on cylinder 347 for the 3348, Model 35, or 
on cylinder 695 for the 3348, Model 70. Fcllowing system generation, 
adequate standard label assignments should be set to support the 
installation's requirements. 

10. Standard labels (OPTION STDLAEEL) are not defined for any file en the 
system distributed by IBM. A reply of delete to the following message 
destroys the system residence file unless it is encountered during a 
MAINT reallocation run: 

DOS. SYSRES. FILE 

4444A OVERLAP ON UNEXPIRED FILE 

The core image library allocations on the IBM-supplied volume (s) are 
not sufficient to contain all of the system components. The adequacy 
of allocations can be determined through the use of Figure 1-18. 

Refer to the section fcr each component fcr core image phase names, 
relocatable module names, and source statement macro names. Phases, 
modules, and macros are identified by compcnent. Also included in the 
section for each component are these statements required fcr linkage 
editing and deleting. 

Maintenance Procedures 

The maintenance of DOS/VS libraries can be performed with the MERGE 
function of the CORGZ librarian program. The MERGE function allows 
complete libraries or selective library entries to be merged into existing 
libraries. When the MERGE function is used, space availability is always a 
consideration. The following discussions apply to all libraries. 

REPLACING IDENTICAL ENTRIES USING MER GE FUNCTION 

When transferring entries that have names identical to those of existing 
entries of a library, the old entry (phase, module, book, or procedure 
name) is deleted from the library's directory, and the new entry is added 
to the end of the library's directory. The phase, module, book, or 
procedure is added to the end of the library. 
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ADDING UNIQUE ENTRIES USING MERGE FUNCTION 

When uniquely named entries (phase, module, book, or procedure name) are 
transferred to an existing library, the narres of the entries are added to 
the end of the library's directory, and the phase, module, book, or 
procedure itself is added to the end of the library. 



?gPggg;j:-Iil:!!j.^§^y Updating Techniques Us ing the Merge Fu nction of the CQRGZ 
Librarian Program 

The techniques presented here apply to the examples given. They are 
intended as a guide and do not necessarily satisfy all requirements. The 
method that you apply to maintain the libraries depends upon the library 
structure, and the special requirements concerning the maintenance cf ycur 
library. 

COPYING SELECTIVELY TO MERGE LIBRARIES 

When there are more entries desired in an existing library, it is faster tc 
selectively copy (MERGE) to the library containing the greatest number cf 
desired entries. Thus, the number of entries transferred and directory 
searches made are kept to a minimum to save time. If there is insufficient 
space in a library to accommodate additional entries, unwanted entries can 
be deleted, the library condensed, and the new entries then added tc the 
library. 

DELETING UNWANTED ENTRIES AND MERGING J^N ENTIRE LIBRARY WITH ANOTHER 
LIBRARY 

A second technique is to apply the IBM-supplied DELETERL or DELETESL book 
to delete all unwanted entries from a library and copy the entire library 
to another library, thus merging the two libraries. Using this technique 
requires that the library being copied to contains enough space to 
accommodate the entire library being copied. If there is insufficient 
space, the library being copied to can be condensed or reallocated. 

COPYING SELECTIVELY t MERGING TWO LIBRARIES TO CREATE A THIRD LIBRARY 

If there is insufficient space to accommodate a merge of two libraries, a 
third library can be created to contain selected entries from the two 
libraries being merged. This technique eliminates the need for condensing 
or reallocating an existing library. Note that this technique can be 
applied by using only two disk drives. 

DELETING UNWANTED ENTRIES FROM TWO LIBRARIES AND MERGING BOTH LIBRARIES TO 
CREATE A THIRD LIBRARY 

Another technique for merging two libraries is to delete unwanted entries 
from the two existing libraries, and merge the two libraries, in their 
entirety, by copying them to create a third library. Note that this 
technique can be applied by using only two disk drives. 
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DOS/VS Distribution Program Job Control Coding Specifications 



Figure 1-12 provides job control inforiration that is to te inserted in the 
program decks described in the sections "Processing the Eistribution Tape" 
and "Creating a Back-Up of ycur Generated Systeir Vcluitie". 



// DATE mrti/dd/yy 
mm = 01-12 
dd = 01-31 
yy = 00-99 



// ASSGN SYSxxx,x'cuu' ,dd[,X' ss' ] 
XXX = logical unit 
cuu = channel and unit of device 

• The channels used by the distribution program supervisor are: 
Multiplexer (channel 0) 
Selector 1 through 6 

dd = one of the following device type codes: 

Cl-3210/3215 Console Printer-Keyboard 
CR-Display Operator Console 

D3-231U/2319 Disk Drive 

D4-3330 Disk Storage Models 1 and 2, or 3333 Disk Storage 

D5-3340 Disk Storage (35 megabyte data irodule) 

D6-3340 Disk Storage (70 megabyte data module) 

L1-1403/1U0«* Printer* 
L2-m43/m45 Printer* 
L3-3203, 3211, or 5203 Printer* 

R1-25U0 Card Read-Punch (reading only) 

R2-25U0 Using Punch-Read-Feed feature 

R3-1442 Card Read-Punch 

R4-2501 Card Reader 

R5-2520 Card Read-Punch 

R6-3505/3504 Card Reader 

R7-2560 MFCM or 5U25 MFCU (read hopper 1) 

Tl-2400 or 3400 7-track Tape 
T2-2U00 or 3400 9-track Tape 

ss = 90 for 7-track tape unit 

CO for 9-track tape 1600 BPI 
C8 for 9-track tape 800 BPI 

♦For printers 1U03, 3203, 3211, and 5203: 
ss = 7B - sense data checks 

= 73 - (default) block data checks (ignore) 



// VTOC STRTADR=(cccchhh) ,EXTENT=(yy) 

cccchhh = cylinder and head nuirber of starting address 

yy = number of tracks allotted to VTOC in decimal (1-20) 

\ 

I VOLlnnnnnn 

L . 



nnnnnn = Volume Serial Num,ber 



Figure 1-12. PROCEDURES--Distribution Program Job Control Coding Specifications 
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Processing the Distribution Tape 

The IBM-supplied systeir residence tape roust te copied onto a disk pack 
before systerti generation can be perforired. The pack that is to contain the 
system must be initialized with a volume label cf 111111 and a volume table 
of contents (VTOC) at cylinder 199 (2314/2319), or cylinder 403 (if a 3330 
Disk Storage is used). For the 3340, the VTOC is assumed to be on cylinder 
347 for the 3348 Model 35 and on cylinder 695 fcr the 3348 Model 70. The 
Initialize Disk or Bypass Initialize Disk procedure is immediately followed 
by the Restore Distribution Tape tc Disk procedure (see section "Restoring 
the IBM-supplied Distribution Tape to Disk"). If the disk pack that is to 
contain the system has already been initialized, proceed to the next 
section, entitled: "Bypassing the Initialize Disk Procedure". 

Initializing the Disk 

I To initialize and restore the disk: \ f l— ^ r"""- v*\ r— / HU^ 



Mount the distribution tape , ,, , , - , ,,r^,..- ,v 

• Ensure that the disk pack or data module is set for read and writ^. 
operations: v 

a) for the 3330, set the write protection switch to R/W 

b) for the 3340, use a read/write data module 

• Place the following control cards in the card reader, in the sequence 

shown: 

// JOB INTDSK 

// ASSGN SYSLOG,X'cuu',dd 

// DATE mm/dd/yy 

// ASSGN SYSOPT,X'cuu' ,dd (disk) see Note 1. 

// ASSGN SYSOOn,X*cuu' ,dd (disk) see Note 2. 

// LOG (optional) 

// ASSGN SYSLST.,X'cuu' ,dd (cpticnal) see Note 6. 

// EXEC 

// UID nn see Note 3. 

// VTOC STRTADR=(cccchhh) ,EXTENT=(yy) see Note 4. 

VOLlnnnnnn see Note 5. 

// END 

// JOB DISRST 

// ASSGN SYS005.,X'cuu* ,dd System residence file to be created 

// ASSGN SYS006,X'cuu' ,dd,ss Distribution tape 

// EXEC 

(for a description of the dd and ss fields see Figure 1-13) 

Notes; 

1. SYSOPT is required to specify the disk device to be initialized. 

2. n = 2,3,4, or 5. SYS002 through SYS005 are optional to specify 
additional disk devices to be initialized. 

3. Refer to DOS/VS System Utilities, GC33-5381, fcr a complete description 
of the UID control card. 

For 2314/2319, nn=: 

IR Previously flagged tracks are to retain their flags without surface 
analysis, or 
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lA Denotes surface analysis on all tracks. Generation of home address 
(HA) and RO records, prefcrroatting of IPL records, writing of 
volume label and VTOC, or 

IS For packs that have already been initialized this entry can be used 
to change the volume label (s) and the VTCC location. 

I For the 3330 or 3340 Disk Storage, nn= : 

IQ Quick initialization. No surface analysis. No home address 
generation, only standard RO generation. IPI records are 
Preformatted, volume labels and VTOC are written, or 

IS See above. 

4. For 2314/2319: cccchhh=0199000 yy=l-20 

For 3330: cccchhh=0403000 yy=l-19 

I For 33UP/3 5?^E: cccchhh=0347000 yy=l-12 

For 3348/70iyiB: cccchhh=0695000 yy=l-12 

For each output disk specified (max. 5) a set of 

// VTOC STRTADR=(cccchhh) ,EXTENT=(yy) 
VOLlnnnnnn 

cards are to be added. 

I 5. nnnnnn = Volume serial number (blanks are permitted) 

Columns 42-51 are reserved for user's identification. A label ccntrcl 
set consisting of a VTOC control card and a VOLl control card is 
required for each pack assigned. The label control sets apply to the 
assignments in the order as specified in the job stream and not in 
strict numerical sequence. 

• IPL from the tape unit that contains the distribution tape volume. 

• When the wait state is entered, press START and EOF on the card reader. 

• If messages S328I and S328A appear on SYSLOG, type DELETE and press 
INTERRUPT to delete unexpired files, one by one. Type DELETE ALL tc 
delete all unexpired files at once. 

• The message INITIALIZE DISK FUNCTIONS COMPLETED appears on SYSLOG when 
initialization is complete, after job control message S2F0I EOJ INTDSK. 
The DOS/VS system is then copied on the disk (Refer to the section 
entitled: "Restoring the IBM-supplied Distribution Tape to Disk"). 

6. If SYSLST is assigned, all messages and other output from the 

initialize disk phases tc the communications device are also printed on 
SYSLST. 



Bypassing the Initialize Di sk Procedu re 

If the disk has previously been prcperly initialized,, the Initialize Disk 
procedure can be omitted and the following procedure performed to bypass 
the initialize disk routine immediately followed by the procedure tc 
restore the IBM-supplied distribution tape to disk: 
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Mount and ready the distribution tape. 

Clear the card reader 

Set write protection switch to R/W (3330 only) 

Place the following control cards in the card reader in the sequence 
shown : 

// JOB INTDSK 

// ASSGN SYSLOG,,X'cuu',dd 

// LOG (optional) 

// DATE iriin/dd/yy 

// FILES SYSIPT,1 

// JOB DISRST 

// ASSGN SYS005,X*cuu'dd Newly created systeir residence file 

// ASSGN SYS006,X'cuu»dd,ss Distribution tape 

Note: For a description of the dd and ss fields see Figure 1-13. 

IPL from the tape unit that contains the distrituticn tape voluire. 

When the wait state is entered, ready the card reader containing the 
control cards by pressing START and EOF. 

The tape forward-spaces past the initialization prograir and after job 
control message S2F0I EOJ INTDKS, the systerr automatically initiates the 
restore system function. 

S130A INTERVENTION REQ DEVICE=CUU 

GIVE REPLY, and/or END/ENTER and INTRPT key 

If this message is displayed, the card reader does net contain the 
required control cards to start the restore procedure. Check the cards 
in the hopper, complete them, ready the reader, then press END cr ENTER 
and the Interrupt key. 



Restor i n g th e IBM-Supplied Distributi on Ta pe to Disk 

After initializing or bypassing the initialize program, the restore 
distribution tape procedure is performed straightaway. 

The system issues the following twc-part message: 

S401D ♦♦♦ GIVE SYSTEM LIBRARY ALLOCATIONS ♦♦♦ (see Note) 



Note: The allocations must be in the format ID=cyl(trk) 

Default allocations for all four system libraries are obtained by 
pressing the END key (the ENTER key on a Model 125), immediately after the 
system displays or prints CL=, RL=, SL=, or PL=. The default values are 
SYSRES type dependent (2314/19, 3330, cr 3340) ; they are listed in section 
7 of the Memorandum to Users. After the END (or ENTER) key is pressed, the 
system displays the default allocations in message SU03I ALLOC DEFAULTS TO 
X ( Y ) . 

If you need larger allocations, type them, in immediately after the 
system prints (or displays) CL=, RL=, SL=, or PL=, then press the END cr 
ENTER key. By so doing you override the default allocations. 
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Type in your system core image library allocation - cyl(trk) - then press 
the 5;nd (or ENTER) key. The systeir prints cr displays: 

RL = 

Type in your system relocatable library allocation - cyl(trk) - and press 
the END (or ENTER) key. The systeir prints cr displays: 



Type in your system source statement library allocation - cyl'(trk) - and 
press the END (or ENTER) key. The system prints or displays: 

PL = 

Type in your procedure library allocations - cyl(trk) - and press the END 
(or ENTER) key. The systeir prints or displays: 

SU09D TYPE GO IF ALLOCATION IS CORRECT 

Type in GO and press the END (or ENTER) key or, if you want to change the 
allocations, just press the key without typing in GO, whereupon the system 
issues again the first (two-part) message. If you type in GO and press the 
END (or ENTER) key, the system successively issues the following procedural 
messages, provided that no errors are encountered: 

S4101 FILE ID=xxx....xx (t*Ux) 

S411I EXTENT=CyL xxxTRKxx-CYLxxx TRKxx 

S412I RESTORE OF SYSTEM CORE IMAGE LIBRARY IN PROGRESS 

S417I RESTORE HAS BEEN SUCCESSFUL 

S412I RESTORE OF SYSTEM RELOCATABLE LIBRARY IN PROGRESS 

S417I RESTORE HAS BEEN SUCCESSFUL 

Stll2l RESTORE OF SYSTEM SOURCE STATEMENT LIBRARY IN PROGRESS 

S417I RESTORE HAS BEEN SUCCESSFUL 

SU12I RESTORE OF SYSTEM PROCEDURE LIBRARY IN PROGRESS 

S417I RESTORE HAS BEEN SUCCESSFUL 

S41UI *♦* RESTORE COMPLETE *** 

Besides procedural messages, error messages may be issued in the course of 
the library allocation procedure (see section "Restore Messages", which 
follows) . 



CREATING A BACK-UP OF YOUR GENERATED SYSTEM 

At the end of system generation, you should copy your system volume in 
order to have back-up available. To do this, use the DOS/VS "Copy Disk cr 
Data Cell to Tape" utility or, for 333 and 33U0 systems, the "Disk Volume 
- Fast Copy" utility. Both are part of 57 45-SC-UTL, and are contained in 
the core image library. 
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Using the "Copy Disk or Data Cell to Tape" program, you can copy your 
system to tape in two ways: 

• Copy volume (complete system pack) 

• Copy file 

The first method is the simpler of the two: all files en the system pack, 
plus any other data, are copied to tape(s) . The second method needs 
specific file information for every file to be copied; moreover, only one 
file can be copied per tape volume. Generally speaking, the second method 
requires more tape volumes than the first. 

Note: This tape is in a format accepted only by the DOS/VS utility RTPDK. 



'^9BXJ: g-§.. ? Y.^1^^^ Disk to Tape 

1, Before the copy disk function can be perform.ed, module IJWCDT must be 
link-edited and cataloged into the core image library, if this has net 
been done yet. Put the following cards in the card reader, in the 
sequence shown: 

// JOB LINKEDIT COPY DISK UTILITY 
// OPTION CATAL 
INCLUDE IJWCDT 
// LBLTYP NSD(IO) 
// EXEC LNKEDT 
/& 

2. To copy your generated system: 

• Mount the system pack. 

• Mount the back-up tape on a tape drive and ready the device. 

• Place the following cards in the card reader, in the sequence shewn: 

// JOB COPY DISK VOLUME TO BACK-UP TAPE 

// ASSGN SYS004,X'CUU* DISK INPUT (VOLUME TO BE COPIED) (Note 1) 

// ASSGN SYS005,X'CUU' TAPE OUTPUT (BACK-UP TAPE) 

// ASSGN SYS003,UA 

// UPSI 001 

// EXEC CDKTP 

// UCR JTV(,,A=(150U) ,E=((3340)) (Notes 2 and 3) 

TF 3330} 

^ ' (2314) 

if 

f w 

Notes: 

1. cuu denotes the channel and unit address. 

2. The parameter A= in the UCR card specifies the most common physical 
record length of the area to be copied te cbtain the best performance. 
(1504 is the maximum length of a record in the core image library.) 

3. The entry E= in the UCR card specifies the device type of the disk 
storage device. 

when the first tape volume is full, the following message will be issued: 

BG 4140A NO ALTERN DRIVE ASSGN UOUT SYS005=cuu 
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The tape is rewound and unloaded by the system. As soon as a new tape 
volume is mounted and the drive is readied, reply as follows to continue 
the job: 



Replacing a full tape volume by another tape may have to be done more than 
once. Not before the whole disk volume has been copied, will the system 
terminate the job with the message: 

BG EOJ COPY ^--^-^ - 

provided the job name-' was indeed COPY.y 



Restoring the Back-Up Tape to Disk 

If your DOS/VS system ever becomes defective, you must restore your back-up 
tape to a disk volume. In order to do this, first of all reload a disk 
pack with the IBM-supplied system tape so as tc obtain a system under 
control of which the restore procedure can be executed. 

Next, the following steps are to be performed: 

1. Using the reloaded FID system, module IJWRTD must be link-edited and 
cataloged into the core image library. Use the following job control 
cards: 

// JOB LINKEDIT RESTORE DISK UTILITY 
// OPTION CATAL 

INCLUDE IJWRTD 
// LBLTYP NSD(IO) 
// EXEC LNKEDT 
/6 

2. To restore your generated system: 

• Mount the back-up tape on a tape drive and ready the device. 

• Mount a disk pack (re-initialized if necessary) and ready the disk 
drive. 

• Place the following job control cards in the card reader, ready the 
reader, and start executing the job: 

// JOB RESTORE BACK-UP TAPE TO DISK 

// ASSGN SYS004,X*CUU' BACK-UP TAPE (Note 1) 

// ASSGN SYS005,X'CUU' OUTPUT DISK 

// ASSGN SYS 00 3, UA 

// UPSI 1 

// DLBL UOUT, 'filename of the system residence file*, 99/365 (Note 2) 

// EXTENT SYS00 5,, ,l,0,nnnnn,mmmmm (Notes 3 and U) 

// EXEC RTPDK 

/g 

Notes: 

1. cuu denotes the channel and unit address. 

2. (filename of the system residence file) can be any name for this 
new system, for instance DOS. SYSRES. FILE. This name will be kept 
temporarily in the Fl label of the VTOC and will eventually be 
overwritten by the original filename of the copied system pack. 
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3. nnnnn=00001 denotes the relative track address cf the lower liirit 
of the SYSRES file which normally starts at cylinder 0, track 1. 

4. mmmmni denotes the nuirber of tracks occupied by the new file (Note 
2). This number is not significant here, because all the back-up 
tapes will be restored regardless of this limit, when your copied 
system has been successfully restored, the original extent limits 
of the copied system are written in the system's Fl label in the 
VTOC. 

If more than one back-up tape is involved, the following message will 
be issued after end-of-reel is detected: 

BG 8001D IS IT EOF 

Reply by typing in n (for 'no'). The tape will be rewound and unloaded 
after which the second back-up tape volume can be ircunted. Meanwhile 
the system will issue the following message: 

BG 4140A NO ALTERN DRIVE ASSGN UIN SYS0 04=cuu 

After the tape drive with the newly mounted reel has been readied, 
reply by typing in: 

newtap 

The above procedure must be repeated for each tape volume to be 
restored. After the last tape has been restored, reply y (for 'yes') 
to the message 

BG 8001D IS IT EOF 
upon which the system issues the final message 

EOJ RESTORE 

provided the jobname was indeed RESTORE. 

3. As a last step, it is advisable to run a LVTOC job tc check whether all 
files have been restored, and to keep track of the extents of the 
files. Before running this job, module IJWLTVB must be link-edited and 
cataloged into the core image library. Use the following job cards in 
the sequence shown: 

// JOB LINKEDIT LVTOC UTILITY 
// OPTION CATAL 

INCLUDE IJWLTVB 
// LBLTYP NSD(IO) 
// EXEC LNKEDT 
/S 

// JOB LIST VTOC 

// ASSGN SYS004„X'cuu' SYSTEM DISK 
// ASSGN SYS005,X'cuu' PRINTER 
// EXEC LVTOC 
/& 
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CREATING A BACK-UP OF AND RESTORING A DISK/ONLY, 2-SPINDLE, 3330 OR 33^*0 
DISK STORAGE SYSTEM USING THE FAST COPY DISK VOLUME UTILITY 

In case your system is generated on a 2-spin(aie 3330 or 3340 Disk Storage 
in a disk-only configuration, it is obvious that no sy stein utility 
operating under control of the DOS/VS supervisor can be used to perfcrir the 
necessary backup and restore procedures. 

For 3330 and 3340 backup, we suggest that ycu use the stand-alone 
version of the Fast Copy Disk Voluire utility, as described in DQS/VS Systeir 
Utilities, GC33-5381. This prograir is to be punched in cards, and will be 
especially useful in a 2-spindle environment when the SYSRES pack must be 
removed in order to mount a scratch pack for copying the data stored on the 
second disk spindle. 

The stand-alone version of the Fast Copy Disk Volume utility is 
contained in the source statement library of the IBM-supplied system under 
the name Z.FASTCOPY. The SSERV program must be used to punch the utility 
program into cards. 
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Supervisor Messages 

SIOOA INVALID RESPONSE, TRY AGAIN 

GIVE REPLY, and/cr ENE/ENTER and INTRPT KEY. 

Cau se; The operator has entered an invalid response to the 
previous message. 

System Acti on : The system stops processing and waits for an 
operator response. 

Operator Action : 

• Verify the acceptable responses tc the previous message and 
enter the desired choise, or 

• Enter C or CANCEL to canel the jot. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ABDR = cccccc 
SIOIW PROGRAM CHECK, OLD PSW = dd d d dddd d d dddddd 
HARD-STOP 

Cause; Program check has occurred. The message displays the 
following information, if available, in hexadecimal notation: 

aa is the last channel ccmniand code executed by the systeir. 

b...b is the channel status word. 

c. .c is the address of the comirand control block. 

d...d is the program old PSW. 

System Acti on : The system enters the WAIT state. 

Opera tor Action : In most cases the operator should obtain a 
storage dump and save the printer and console output for the IBM 
customer engineer. To restart the system, re-IPL. 

S102W JOB xxxxxx CANCELED BY OPERATOR. 
HARD- STOP 

Cause: The operator has entered a response that has caused the 
program to be canceled. 

Sys tem A c tion : The system enters the WAIT state. 

Operator ^ Ac ti on : To restart the system, re-IPI. 
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CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddclddddd 
S103W NO ERP SUPPORT DEVICE = cuu 
HARD-STOP 

Cause: An error has been encountered on the indicated I/O device 

for which this version cf the stand-alone supervisor does not 

support an error recovery procedure. The rressage displays the 

following information, if available, in hexadecimal notation: 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

System Action: The system enters the WAIT state. 

Operat or Action : To restart the system, re-IFL. 

CCSW = aa bbbbbbbbbbbbbbbb CCE ADDR = cccccc 
SENSE=dddddddddddddddddddddddddddddddddddddddddddddddd 
SIOUW CHANNEL ERROR DEVICE=cuu 
HARD-STOP 

Ca us e; A channel error has occurred during an input/output 
operation on the indicated device. This is probably a hardware 
error. The message displays the following information, if 
available, in hexadecimal notation: 

aa is the last channel command cede executed by the system. 

b...b is the channel status word, 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

Sy stem Action ; The system enters the WAIT state. 

Operator Action; To restart the system., re-IPL. If the error 
persists^ notify the IBM customer engineer. 

I S105A IN REP CARD INVALID HEX CODE GROUP: xxxxxx 

GIVE REPLY, and/or END/ENTER and INTRP KEY. 

Cause; A REP card, containing the indicated invalid hexadecimal 
address or data between slashes (/), has been read by the loader 
routine in the supervisor. 

S ystem Action : The system stops processing and waits for an 
operator response. 

Operator Action : 

• Replace the incorrect card with a new REP card and resubmit 
it, followed by all remaining cards; then enter R or RETRY to 
continue processing, or 

• Enter I or IGNORE to bypass the invalid REP card and continue 
processing, or 
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• Enter C or CANCEL to cancel the job. 

After ENTERING your response, press the END/ENTER key and then 
the INTERRUPT key. 

SlxOA INTERVENTION REQ DEVICE=cuu 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause: The device whose channel and unit designation is 
identified in the iressage, has been addressed by the prograrr and 
is not in a ready status. The device type is indicated by the 
third character in the rressage number, as follows: 

X = 1 - disk 

2 - magnetic tape 

3 - card 

4 - printer 

5 - console printer keyboard 

If the last three characters of the iressage nuirber are XOA, the 
sy stern is unable to identify the device type. 

System Action: The system waits fcr the operator response. 
Operator Action : 

• Ready the device to continue processing, or 

• Enter C or CANCEL to cancel the job. 

You should then press the END/ENTER key followed by the interrupt 
key, 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=dddddddddddddddddddddddddddddddddddddddddddddddd 
SlxlfW) EQUIPMENT CHECK DEVICE=CUU 



HARD-STOP 

GIVE REPLY, and/or ENE/ENTER and INTRPT KEY. 

Cause; This is probably a hardware error. The indicated device 
may have an internal malfunction or iray have dropped, possibly 
only momentarily, from the ready status during a data transfer 
operation. The message displays the following information, if 
available,, in hexadecimal notation: 

aa is the last channel ccmand code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

The device type is indicated by the third character in the 
message number, as follows: 

X = 2 - magnetic tape 

3 - card device 

4 - printer 

5 - console printer keyboard 
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:eni Action: If the suffix to the message number is W, the 
system enters the WAIT state. If the suffix is A, the systerr 
stops processing and waits for an operator response. 

Operator Action; For a W suffix to the message number, re-IPL to 
restart the system. If the error persists, notify the IBM 
customer engineer. For an A suffix to the message number: 

• Correct the condition which caused the error, ready the I/O 
device, and enter R or RETRY to continue processing. 

• enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the interrupt key. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=dddddddddddddddddddddddddddddddddddddddddddddddd 
Slx2fW] BUSOUT CHECK DEVICE=CUU 



Ia! 



HARD-STOP 

GIVE REPLY and/or END/ENTER and INTRPT KEY. 

Cause: A unit chGck, caused by a parity error, occurred on the 
indicated device. This is probably a hardware error. The 
message displays the following information, if available, in 
hexadecimal notation: 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the commiand control block. 

d...d is up to 21 bytes of sense information. 

The device type is indicated by the third character in the 
message number, as follows: 

X = 2 - magnetic tape 

3 - card device 

4 - printer 

5 - console printer keyboard 

System Action: If the suffix to the message number is W, the 
system enters the WAIT state. If the suffix is A, the system 
stops processing and waits for an operator response. 

Operator Action: For a W suffix to the message number, re-IPL to 
restart the sysfcerci. If the error persists, notify the IBM 
customer engineer. For an A suffix to the message number: 

• Perform any required manual recovery procedure for the 
particular I/O unit and ready the device. Enter R or Retry to 
continue processing. 

• enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 
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CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddadddddddddddclclddddddclddddddddddddddddddcldclcldddd 
Slx3W COMMAND REJECT DEVICE=CUU 
HARD-STOP 

Cause; The specific channel contirand was rejected as being 
illegal for the device indicated by the channel and unit nurcber. 
The message displays the following information, if available, in 
hexadecimal notation: 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

The device type is indicated by the third character in the 
message number, as follows: 

X = 1 - disk 

2 - magnetic tape 

3 - card device 

4 -• printer 

5 - console printer keyboard 

Syste m Action : The system enters the WAIT state. 

Operator Action : In most cases the operator should obtain a 
storage dump and save the printer and console output for the IBM 
customer engineer. To restart the system, re-IPL. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
SlxUW OVERRUN DEVICE=CUU 
HARD-STOP 

aa is the last channel command cede. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

The device type is indicated by the third character in the 
message number, as follows: 

X = 2 - magnetic tape 

3 - card device 

4 - printer 

5-console printer keyboard 

System Action: The system enters the WAIT state. 

Operator Action: To restart the system, re-IPL. If the error 
persists, notify the IBM customer engineer. 
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CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
S125A LOAD POINT DEVICE=cuu 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause: Load point has been encountered en an input magnetic tape 
on the indicated channel and unit during execution of the error 
recovery procedure. This usually occurs during back spacing for 
a tape cleaning operation. The message displays the following 
information, if available, in hexadecimal notation: 

aa is the last channel command cede executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d,..d is up to 2U bytes of sense information. 

System Acti on ; The system stops processing and waits for an 
operator response. 

O perato r Action : Enter C or CANCEL to cancel the job. Then 
press the END/ENTER key and the interrupt key. Clean the tape 
dri\'e, remount the tape, IPL and re-start the job. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
Slx6(W) DATA CHECK DEVICE=cuu 



1a 



HARD-STOP 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause; An uncorrectable parity error or an invalid character has 
been detected during a data transfer operation on the indicated 
device. The message displays the following information, if 
available,, in hexadecimal notation: 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 2H bytes of sense information. 

The device is indicated by the third character in the message 
number, as follows; 

X — 2 ^ uiagnetxc tape 

3 - card device 

4 - printer 

5 - console printer keyboard 

System Action; If the suffix to the message number is W, the 
system enters the WAIT state. If the suffix is A, the system 
stops processing and waits for an operator response. 

O perato r Action; For a W suffix to the message number, re-IPL to 
restart tHe system. If the error persists, notify the IBM 
customer engineer. For an A suffix to the message number: 

• Perform any required manual recovery procedure for the 

particular device (for example, repunch an input data card to 
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eliminate an invalid character) and ready the device. Enter R 
or RETRY to continue processing. 

• Enter C or CANCEL to cancel the jet. 

After entering your response, press the END/ENTER key and then 
the interrupt key. 

CCSW = aa bbbbbbbbbbbbfcbfcb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
S127A NON COMPATIBILITY DEVICE=CUU 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause: Incoirpatibility has been detected between the magnetic 
tape characteristics specified in the ASSGN card for this device 
and those encountered on the indicated input tape. The 
incompatible characteristic could be density, parity or number of 
tracks. The message displays the following information, if 
available, in hexadecimal notation: 

aa is the last channel command cede executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

Sy s tem Action ; The system stops processing and waits for an 
operator response. 

Operator Action : 

• Mount the correct tape and enter R or RETRY to continue 
processing, or 

• Prepare a new ASSGN card that properly describes the 
characteristics of the tape to be processed. Enter C or 
CANCEL to cancel the job; re-IPL to restart the system and 
re-run the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
S128W PERSIST WRITE ERROR DEVICE=CUU 
HARD-STOP 

Cause; A persistent write error has occurred en the indicated 
magnetic tape which the error recovery procedure cannot correct. 
The message displays the following information, if available, in 
hexadecimal notation: 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 24 bytes of sense information. 
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Systeni Action ; The systeiti enters the WAIT state. 

Operator __ Action ; Replace the magnetic tape which caused the 
error. Insure that cleaning procedures for the tape drives are 
being carried out. To restart the system, re-IPL. If the error 
recurs, notify the IBM customer engineer. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ACDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
S129W WORD COUNT ZERO DEVICE=cuu 
HARD-STOP 

Cause; A magnetic tape hardware error has occurred on the 
indicated device. No data transfer occurred during the last tape 
operation. The message displays the following information, if 
available, in hexadecimal notation; 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

di..d is up to 2i* bytes of sense inforrnation. 

Syste m Action ; The system enters the WAIT state. 

O per ator Action; In most cases the operator should obtain a 
storage dump and save the printer and console output for the IBM 
customer engineer. To restart the system, re-IPL. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
S12BW NOISE RECORD DEVICE=cuu 
HARD-STOP 

Cause; A record less than 12 characters in length has been 
encountered on the indicated magnetic tape. The message displays 
the following information, if available, in hexadecimal notation; 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 2 M bytes of sense information. 

Syste m Action ; The systerri enters the WAIT state. 

Operator Ac tion ; To restart the system, re-IPL. Insure that 
tape drive cleaning procedures are being carried out. 

S12CA FILE PROTECTED DEVICE=cuu 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause; A write command was issued to the indicated magnetic tape 
drive that contains a reel from, which the file protect ring has 
been removed. 

Syste m Action ; The system stops processing and waits for an 
operator response. 
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• A tape, with a file protect ring inserted, must be mounted on 
the tape drive; enter R or RETRY to continue processing, cr 

• Enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 
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CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
DEVICE NOT ATTACHED DEVICE=cuu 
HARD-STOP 



Cause: The device corresponding to the channel and unit number 
addressed by the program is not available on the system, cr the 
device is switched to disabled mode. The message displays the 
following information, if available, in hexadecimal notation: 

aa is the last channel command cede executed by the system. 

b...b is the channel status word. 

G,..c is the address of the command control block. 

d...d is up to 24 bytes of sense information. 

The device type is indicated by the third character in the 
message number, as follows: 

X = 2 - magnetic tape 

3 - card device 

4 - printer 

5 - console printer keyboard 

Sys te m Actio n; The system enters the WAIT state. 

O pera t or A ctio n ; Correct the device assignment which addressed 
the invalid channel and unit number, or switch the device to 
enabled mode. To restart the system, re-lPL. 
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CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
PERMANENT ERROR DEVICE=CUU 
HARD-STOP 

Cause; A permanent hardware error has occurred during a disk I/O 
operation on the indicated device. The message displays the 
following information, if available, in hexadecimal notation: 

aa is the last channel command cede executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 2U bytes of sense information. 

S ystem _ Acti on : The system enters the WAIT state. 
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Oper ator Actio n; In most cases the operator should obtain a 
storage dump and save the printer and console output for the IBM 
customer engineer. To restart the system, re-IPL. 

SllHA WRITE INHIBITED DEVICE ADDR=cuu 

GIVE REPLY, and/cr END/ENTER and INTRPT KEY. 

Cause: A write coirmand was issued to the indicated disk drive on 
which the write-inhibit switch is set to allow reading only. 

System Action; The system stops processing and waits for an 
operator response. 

Op erator Action : 

• Change the switch setting on the device to allow both reading 
and writing and enter R or RETRY (cr enter no reply) to 
continue processing. 

• Enter C or CANCEL to cancel the jcb. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
SllJW BAD TRCK CCCHH=CCChh DEVICE=CUU 
HARD-STOP 

Cause; A permanent disk read or write error has occurred on the 
indicated device. The message displays the following 
information, if available, in hexadecimal notation. 

aa is the last channel command code executed by the system. 

b...b is the channel status word. 

C...C is the address of the command control block. 

d...d is up to 2H bytes of sense information. 

c...h is the defective cylinder and track number. 

System Action ; The system enters the WAIT state. 

Operator Action ; To restart the system, re-IFL. If the errcr at 
this physical~address on the disk persists, the DOS/VS utility 
"Assiyii Alternate Track" should be run, permanently assigning an 
alternate track to replace the defective one. 

CCSW = aa bbbbbbbbbbbbbbbb CCB ADDR = cccccc 
SENSE=ddddddddddddddddddddddddddddddddddddddddddddddddd 
SlxGW I/O ERROR DEVICE=CUU 
HARD-STOP 

Cause; An I/O error has occurred during an operation on the 
indicated device. It cannot be corrected by the error recovery 
procedure. The message displays the following information, if 
available, in hexadecimal notation: 



aa 



is the last channel command code executed by the system. 
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b...b is the channel status word. 

C...C is the address of the comirand control tlock. 

d...d is up to 24 bytes of sense information. 

The device type is indicated by the third character in the 
message number as follows: 

x=l - disk device 
x=3 - card reader 
x=5 - console printer keyboard 

System Action: The system enters the WAIT state. 

O pera tor Action ; To restart the system, re-IFL. If the error 
persists, notify the IBM customer engineer. 



Job Control Messages 



S200D PAUSE 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause; A // PAUSE card has been read by job control. 

System Actio n; The system stops processing after the // EXEC 
card has been read and waits for an operator response. 

Operator Acti on : To resume processing, press the END/ENTER key 
and then the INTERRUPT key. 

S210A DUPLICATE JOB CARD 

GIVE REPLY, and/or END/ENTER and INTRPT KEY 

Cause: Additional // JOE card(s) has been encountered without an 
intervening // EXEC card. (Only one // JOB card per job is 
allowed.) 

Sys te m_ Action ; The system stops processing and waits for an 
operator response. 

Operator Action : 

• Enter I or IGNORE to cause the system to disregard the second 
JOB card and continue processing, or 

• Enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

S220A MISSING JOB CARD 

GIVE REPLY, and/or END/ENTER and INTRPT KEY. 

Cause; The first control statement for each job must be the 
// JOB card. This statement was not found by the job control 
program at the point where it should have been encountered. 

Sys te m Action; The system stops processing and waits for an 
operator response. 
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O p er a tor ^ Ac tion : 

• Resubmit the job control cards, placing the // JOB card ahead 
of the others; then enter R or RETRY (or do not enter any 
reply) to continue processing, or 

• Enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

No te; The message will appear on the console printer keyboard 
only if an assignirent for SYSLOG has been irade by placing the 
appropriate REP card -in the supervisor object deck, otherwise, 
the system will not be able to display the message because the 
job control card assigning SYSLOG will not have been read. 

S230A NO •// ' IN COL. 1-3 

GIVE REPLY, and/or END/ENTER and INTRPT key. 

Cause; Each job control card must begin with // in card ccluirns 
1 and 2 and a blank in column 3. The last statement read by the 
job control program does not have these characters in the first 
three columns. 

Syst em Action ; The system stops processing and waits for an 
operator response. 

Ope rator A c t ion ; 

• Remove the card and replace it with a job control card in the 
correct format; then enter R or RETRY (or do not enter any 
reply) to continue job control processing, cr 

• Enter I or IGNORE to bypass the incorrect card and continue 
job control processing, or 

• Enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

S240A INVALID CONTROL CARD 

GIVE REPLY, and/or END/ENTER and INTRPT key. 

Ca u se ; Misspelled or missing operation field following the two 
slashes in the job control card. 

S] ^s i .efti Action; The system stops processing and waits for an 
operator response. 



• Correct the error and re-submit the card and all the following 
cards; then enter R or RETRY to continue processing, or 

• Enter I or IGNORE to cause the system to disregard the 
incorrect card and continue processing, or 

• Enter C or CANCEL or cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 
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S250A MISSING DATE CARD 

GIVE REPLY, and/or END/ENTER and INTRPT key. 

Cause: After the IPL procedure, the DATE card must be included 
at some point between the // JOB and // EXEC cards . No DATE card 
was found. 

Sys t e m A ction; The system stops processing and waits for an 
operator response. 

Operator Response : 

• Place the DATE and EXEC cards and all the following cards in 
the card reader; then press R or RETRY to continue processing, 
or 

• Enter C or CANCEL to cancel the job. 

After entering your response, press the END/ENTER key and then 
the INTERRUPT key. 

S260A OPERAND n INVALID 

GIVE REPLY, and/or END/ENTER and INTRPT key. 

Cause; The number n, inserted into the iressage indicates the 
parameter which the job control program has analyzed to be in 
error. 

System Action: The system stops processing and waits for an 
operator response. 

Operat or Action: 

• Repunch the incorrect card and resubmit it, with the remaining 
unread job control cards; then enter R or RETRY to continue 
job control processing, or 

• Enter I or IGNORE to cause job control to bypass and ignore 
the incorrect card and continue processing, or 

• Enter C or CANCEL to cancel the job. 

After entring your response, press the END/ENTER key and then the 
INTERRUPT key. 

S2F0I EOJ jobnarae 

Cause; Normal end-of-job was reached. 

S ystem Action ; Job Control will attempt to read the next set of 
control cards from SYSRDR to initiate the next job. 

Operator Action: None. 



Initialize Disk Messages 

S300A INVALID RESPONSE, TRY AGAIN 

Cause: An invalid response to a previously displayed message. 
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S y stem Action; The systeiri waits for an operator response. 

Operator Action : 

• Select and enter a valid response to continue processing, cr 

• Enter C or CANCEL to cancel the job. 

S302W JOB INTDSK CANCELED DUE TO PROGRAM REQUEST 

Cause;' Conflicting job specifications detected. 

Syst em Action; The system enters the wait state. 

Oper ator Action ; Check the previously displayed SYSLOG output to 
resolve the conflicting conditions, then re-IPL and rerun the 
job. 

S310I CONTROL CARD ANALYSIS AND LABEL CHECKING 

Cause; Identifies beginning of initialize disk function. 
System Action; Processing continues. 
Response; None. 



S311I UTILITY MODIFIER CARD 

Cause; Identifies the ccntrcl card parameters that follow this 
heading. 

Syste m A ction; Processing continues. 

Operator Action ; None. 

S312I MISSING UTILITY MODIFIER CARD 

Cause; Utility modifier is missing. 

System Action; The system displays message S302W, then cancels 
the job and enters the wait state. 

Operator Action; Reload program with corrected control cards. 

33131 INVALID FOkMAT 

Cause; Format is incorrect (either a parameter is missing or it 
is out of order) . 

System Action; The system displays message S302W, then cancels 
the job and enters the wait state. 

Operatpr Action; Reload program with corrected control cards. 

S314I INVALID I (or C or R) PARAMETER 

Cause; Parameter value is incorrect. 
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System Action; The system displays iressage S302W, then cancels 
the job and enters the wait state. 

Operator Action ; Reload program with corrected control cards. 

S320I JOB CARD NOT INTDSK 

Cause; Job name in job card is not INTDSK. 

Sy stem Action : The system displays message S302W, then cancels 
the job and enters the wait state. 

Operator Action: Reload program with corrected control cards. 

S3 211 SYSOPT NOT DEFINED 

Cause: SYSOPT has not been assigned. 

System Action; The system displays iressage S302W, then cancels 
the job and enters the wait state. 

Operator Actipn: Reload program with corrected control cards. 

S322I SYSOPT(002,003, etc) NOT A VALID DISK DRIVE 

Cause: Indicated symbolic unit is net a disk drive in JCL 
syntax. 

System Action; The system displays iressage S3C2W, then cancels 
the job and enters the wait state. 

Operator Action ; Reload program with corrected control cards. 

S323I X'*CUU* NOT A VALID DISK DRIVE 

PACK IS DELETED FROM FURTHER PROCESSING 

Cause: Indicated disk drive is net IBM supported, or there is a 
wrong 'cuu* specification. 

Syst em Action ; The system switches to the next drive, if 
assigned. If no other drive is assigned the job is canceled and 
the system enters the wait state. 

Operator Action: Reload program with corrected control cards if 
the job is canceled; otherwise no action is required. 

S32UI DISK TYPE SPEC FOR SYS002 (003, 004, or 005) IS NOT EQUAL SYSOPT 
PACK IS DELETED FROM FURTHER PROCESSING 

Cause; Indicated symbolic unit differs from SYSOPT type as 
specified in JCL syntax. 

System Action: Processing continues without this unit being 
used. 

Operator Ac tion ; None. 
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S325I xxxx DISK TYPE ON X'cuu* WHILE yyyy EXPECTED 
(E.G. xxxx=2314 and yyyy=3330) 
PACK IS DELETED FROM FURTHER PROCESSING 

Cause: Indicated disk drive differs frorr specification in job 
control language (JCL) . 

§Y§Jr!^i..^£:^4;Q" ' Processing continues without this unit being 
used. " 

Operator Action : None. 

S326I NO VOLl LABEL (or FH LABEL or VTOC AREA) FOUND ON X'cuu' 
•IS' OPTION INVALID 

Cause ; Pack on indicated drive is to be regarded as not being 
initialized, because no VOLl label, F4 label, or VTOC was found, 

System Action: The system displays message S302W, then enters 
the wait state. 

QEg^°l.^Q?!!-^9!!^ 49^ • Reload program after 'IS* option in utility 
modifier card has been changed. 

S327I NO VTOC MATCH FOUND ON X'cuu'. 'IS' OPTION INVALID 

Cause; Pack on indicated drive is tc be regareded as not being 
initialized, because device constants do not match. 

System Action; The system displays message S302W, then enters 
the wait state. 

Operator _Action : Reload program after 'IS* option in utility 
modifier card has been changed. 

S328I UNEXPIRED FILE ON xxxx AT X'cuu': 
S328A '(filename from Fl label)'. 

Cause: Identified file is not yet expired. 

System Action ; The system waits for an operator response. 

Operat or Actio n : 

• Type in DELETE and press INTERRUPT to delete file by file. 

• Type in DELETE ALL to delete this and all ether files. 

• Type C or CANCEL to terminate the job (wait state) . 

• Type in BYPASS to stop processing this pack, and continue 
processing the next unit, if assigned. 

After each of these replies, press END/ENTER, then press the 
interrupt key to continue processing. 

S329I DATA CHECK IN COUNT FIELD, DEVICE=CUU 

Cause; A data check occurred while reading a count field cf a 
track on the indicated disk device. Probably a hardware error. 
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system Action: If other disk drives have been assigned, 
processing continues. A second message viill be displayed, 
indicating the systeir action taken and possibly the operator 
action to be taken with regard to the drive on which the data 
check occurred. 

Operator Action ; None. 

S330A READ ERROR F-4 LABEL OF OUTPUT-FILE, DEVICE=CUU 

Cause; An error was detected while reading an output file format 
4 label. 

System Action; The system waits for an operator response. 



• Press END or ENTER, then press the interrupt key to continue 
processing, or 

• Type C or CANCEL to terminate the job. 

S331A NO F-4 RECORD FOUND OR END-OF-CYL, DEVICE=cuu 

Cause; No F-4 label detected before end-of-cylinder was reached 
in the VTOC. 

jSystem Action: The system waits for an operator response. 

Operator Action ; 

• Press END or ENTER, then press the interrupt key to continue 
processing, or 

• Type C or CANCEL to terminate the job. 

S332A READ ERROR VOL LABEL OF OUTPUT-FILE, DEVICE=cuu 

Cause: An error was detected while reading an output file VOL 
label. 

Syste m Action; The system waits for an operator response. 

Operator Action; 

• Press END or ENTER, then press the interrupt key to continue 
processing, or 

• Type C or CANCEL tc terminate the job. 

S333A NO VOLRECORD FOUND OR END-OF-CYL, DEVICE=cuu 

Cause; No VOL label detected before end-of-cylinder was reached 
in the VTOC. 

System Ac ti o n; The system waits for an operator response. 
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Operato r Action : 

• Press END or ENTER, then press the interrupt key to continue 
processing, or 

• Type C or CANCEL tc terminate the jot. 

S334A READ ERROR VTOC SCAN OF OUTPUT-FILE, DEVICE=CUU 

Cau se; A read error occurred while searching the output file 
VTOC. 

System A ctio n; The system waits for an operator response. 

Operator, Action ; 

• Press END or ENTER, then press the interrupt key to continue 
processing, or 

• Type C or CANCEL to terminate the job. 

S335A NO VTOC RECORD FOUND OR END-OF-CYL, DEVICE=cuu 

Cause; No output-file VTOC record (s) found before 
end-of-cylinder was reached. 

System, A ction ; The system waits for an operator response. 

Opera tor Action ; 

• Press END or ENTER, then press the interrupt key tc continue 
processing, or 

• Type C or CANCEL tc terminate the job. 

S336I 'IS* OPTION INVALID 

Ca us e; A condition is detected which is in conflict with the 
•IS* option specified in the // UID control card. 



1. If the SYSOPT assignment is being processed the system 
cancels the job and enters the wait state. 

2. The system starts processing another disk pack, if assigned^ 
Operator , Act ion ; 

1. Resolve the conflicting condition, then re-IPL. 

2. None. 

S337I PERMANENT ERROR, DEVICE=cuu 

Cause; An error occurred while reading from a 3330 or 33i»0 disk. 
A number of rereads have not resolved the error condition,, which 
is probably caused by a hardware failure. 
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System Action; If other disk drives have been assigned, 
processing continues. A second message \«ill te displayed, 
indicating the system action taken and possibly the operator 
action to be taken with regard to the drive on which the errcr 
occurred. 

Operator Action : None. 

S3 4 01 SURFACE ANALYSIS AND HA-RO GENERATION 

Cause: Identifies the function of this phase (2314/19 only) . 

System Action ; Processing continues. 
Oper ator Action : None . 

S3 411 NO SURFACE ANALYSIS, ONLY RO GENERATION 

Cause; Identifies the function of this phase for the 3330 only. 
Syst em Action : Processing continues. 
Operator Ac tion ; None . 

S342I SYSOPT(002,003,etc.) IN PROCESS 

Cause; Disk packs to be processed will be logged with their 
respective message, starting with SYSOPT. 

System Action; Processing continues. 

Operato r Action ; None . 

S350I CYL XXX TRK xx (DECIMAL), IS 

A DEFECTIVE ALT TRK, NO ALT TRK ASSINGED 

Cause: Cylinder and track are identified by decimal characters. 
The track on the alternate cylinder is defective. An alternate 
is not assigned. 

System A ction : Processing continues. 

Operator Action: None. 

S351I CYL XXX TRK xx (DECIMAL) IS 

DEFECTIVE, AN ALT TRK IS ASSIGNED 

Cause; Main area of the track identified by cylinder and track 
number is defective. An alternate is assigned. 

System Action : Processing continues. 

Operator Action : None. 

S352I CYL XXX TRK xx, (DECIMAL), IS 

DEFECTIVE, AN ASSIGNED ALTERNATE TRK WAS DETECTED 
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Cause: Main area of the track identified by cylinder and track 
number is defective. An alternate track had already been 
I assigned (3330 and 3340 only). 

System Action; Processing Continues. 

Operato r Action ; None. 

S353I CYL XXX TRK xx (DECIMAL), IS 

DEFECTIVE, ALT CYL IS FULL NO ALT TRK ASSIGNED 
SYSxxx IS DELETED AFTER PROCESSING IS FINISHED 

Cause; This defective track cannot be assigned an alternate 
track, Tke alternate cylinders are full. 

System Action; No corrective action taken. Surface analysis 
(2314 only) and RO generation are performed on the rest of the 
pack, then the pack will be deleted from further processing. 

(Neither a VOLl label nor a VTOC will be created. Use cf this 
pack should be discontinued. Contact your IBM customer engineer 
or the branch office serving your area. 

Operator Action: Replace the faulty pack with another disk pack, 
then re-IPL. 

S354I CYL XXX TRK xx (DECIMAL) , IS 

HOME ADDRESS (HA) OR RECORD ZERO (RO) DEFECT. 
SYSxxx IS DELETED AFTER PROCESSING IS FINISHED 

Cause; Portion of the track where the home address or record 
zero resides is defective. 

System Action: No corrective action taken. Surface analysis 
(2314 only) and RO generation are performed on the rest of the 
pack, then the pack will be deleted form further processing. 

(Neither a VOLl label nor a VTOC will be created. Use of this 
pack should be discontinued. Contact your IBM customer engineer 
or the branch office serving your area. 

Operator Action: Replace faulty pack with another disk pack, 
then re-IPL. 

I S355I CYL 000 TRK 00 (DECIMAL) , IS 

DEFECTIVE, NO ASSIGNED ALT TRK WAS DETECTED 
SYSxxx IS DELETED AFTER PROCESSING IS FINISHED 

Cause; Main area of the track identified by cylinder and track 
number is defective. No alternate track had been assigned (3330 
only) . 

System Action; No corrective action taken. RO generation is 
performed on the rest of the pack. After that processing the 
pack is terminated. 

Oper ator Action ; Replace the faulty pack with another disk pack, 
then re-IPL. 
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S356I CYL XXX TRK xx (DECIMAL), IS 

DEFECTIVE, NO ASSIGNED ALT TRK WAS DETECTED 
A STANDARD VTOC WILL BE CREATED ON SYSxxx 

Cause: The main area of the track identified by cylinder and 
track number is defective. No alternate track has been assigned 
(3330 and 33U0 only) . 

System Action; No corrective action is taken. RO generation is 
completed on the rest of the pack (3330 and 3340). User VTOC 
specifications are neglected; a standard VTOC will be created 
later to minimize the occurrence of any errors (See message 
S381I). 

Operato r Action : This disk pack should be subjected to the 
DOS/VS "Assign Alternate Track" function, which cannot be run, 
however, until your generated DOS/VS system is available. 
Replace the pack and re-IPL. 

S370I *VOL/VTOC LABLES CONTROL SET* 

Cause: Identifies sets cf VOLl and VTOC cards. 
System Action: Processing continues. 
Operator Acti on : None . 

S371I INITIALIZE DISK FUNCTIONS COMPLETED 

Cause: Normal end of job has been reached. 

I System Action; The system initiates the next job (restore 

SYSRES) . 

Opera tor Action ; None. 

S372I SYSOPT (002, 003, etc.) DELETED 

Cguse; Identified disk pack is deleted form further processing. 
System Action: Processing continues. 
Operator Action: None. 

S373A VTOC CARD MISSING OR INCORRECT 

Cause; VTOC card is missing or is incorrect. 

System Action; The system waits for an operator response. 

Operator Action : 

• Correct the // VTOC card in the volume label set (including 
VOLn cards) . 

• Place cards in the read hopper and ready the reader. 

• Press END or ENTER and interrupt key to continue. 
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S374A INVALID VTOC ADDRESS OR INVALID EXTENT PARAMETER 

Cause; Invalid VTOC start address or invalid (or missing) EXTENT 
parameter. 

System Action: The system waits for an operator response. 

O perat or A ctipn ; 

• Correct the // VTOC and the VOLn cards in the volume label 
set. 

• Place the cards in the read hopper and ready the reader. 

• Press END or ENTER, then press the interrupt key to continue. 

S375A VTOC OVERFLOWS CYLINDER 

Cause; Assigned VTOC area overflows the cylinder. 

System Action; The system waits for an operator response. 

Op e rator A c t i o n : 

• Correct the // VTOC and the VOLn cards in the volume label 
set. 

• Place the cards in the read hopper and ready the reader. 

• Press END or ENTER, then press the interrupt key to continue. 

S376A VOLl CARD MISSING OR VOLl-n OUT OF SEQUENCE 

Cause: VOLl card is missing, an incorrect volume card was 
supplied, or VOLl through VOLn are out of sequence. 

System Action; The system waits for an operator response. 

Operat or Actio n : 

• Correct the VOL label card in the volume label set (beginning 
with // VTOC card followed by VOLn cards) . 

• Place the cards in the read hopper and ready the reader. 

• Press END or ENTER, then press the interrupt key to continue. 

S377I VOLl SERIAL FIELD CONTAINS BLANKS 

Cause; VOLl card has one or more blanks in the volume serial 
field. 

S y s te m A c tio n ; Processing continues. 

O perato r Action ; None . 

S378A VTOC CARD OR END CARD OR VOL CARD ERROR 

Cause; Wrong VTOC or END control card, or END card is missing 
(Proper format is either '// VTOC * or •// END ' ~ probably a 
mispunch) . 
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Sy stem Action; The system waits for an operator response. 

Operator Action : 

• Correct the cards in the volume label set (beginning with 
// VTOC card followed by VOLn cards) . 

• Place the cards in the read hopper and ready the reader. 

• Press END or ENTER, then press the interrupt key to continue. 

S379A VTOC CARD SETS UNEQUAL NUMBER OF ASSIGNED PACKS 

Cause: VTOC card sets and the number of assigned packs do not 
match. 

Sys te m Acti on : The system waits for an operator response^ 

Operator Act ion : 

• Add another set of volume label cards (beginning with // VTOC 
card followed by VOLn cards). 

• Place these cards in the reader hopper and ready the reader. 

• Press END or ENTER, then press interrupt key to continue. 

S380A PARAMETER DELIMITER ERROR 

Cause: Comma or blank must follow the parameter. 

System Action: The system waits for an operator response. 

Operator Action: 

• Correct the card(s) in the volume label set (beginning with 
// VTOC card followed by VOLn cards) . 

• Place the cards in the read hopper and ready the reader. 

• Press END or ENTER, then press interrupt key to continue. 

S381I USER'S VTOC OVERRULED DUE TO SEVERE ERROR(S) 

Cause: During a previous step of the initialize disk procedure a 
faulty track was detected (see message S356I) while no alternate 
track had been assigned. 

System Action; A standard VTOC is created. 

Operator Action ; This pack should be subjected to the DOS/VS 
"Assign Alternate Track" function, which cannot be run, however, 
until your generated DOS/VS system is available. 

S382A VOL NUMBER NOT NUMERIC 

Cause; n in VOLn was not a numerical character. 

System Action; The system waits for an operator response. 
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Operat or Action: 

• Replace the faulty VOL label card in the volume label set (the 
set starts with a // VTOC card, followed hy VOLn cards) . 

• Place the cards in the read hopper and ready the card reader. 

• Press END or ENTER, then press the interrupt key to continue. 

S3 831 MAXIMUM EIGHT VOL CARDS ALLOWED, CARD SKIPPED 

Cause; A VOL number higher than 8 detected in the volume label 
set. 

System Acti on ; The card in error is skipped, processing 
continues. 

Qp e ratpr Action : None. 

S399D BAD PACKS FLAGGED, RECHECK THE RESTORE-DISK JCL 

Cause; This; message is displayed at the end cf the initialize 
disk procedure to indicate that severe error conditions with 
respect to defective tracks were detected. 

System Action; The system waits for an operator response. 

Operator Action ; 

s Check the job control cards of the next job to be initiated (. 

(restore SYSRES). ^ 

• Change any disk assignments that refer to the bad packs. 

• Place the corrected jcb control cards for the restore disk 
program in the read hopper and ready the card reader. 

• Press END or ENTER, then press the interrupt key to start the 
restore disk program. 



Restore Messages 

S405I SYNTAX ERROR 
Cause; 

• Characters other than numerals (0-9) or parentheses specified 
in system library allocation, or 

• More than 16 digits used for library or directory allocation. 
System Action; Display cf CL=, RL=, or SL= is repeated. 
Operator Action; Type in correct allocation. 

S406I ALLOCATION ERROR 

Cause; Zero size specified for either a library or directory. 
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System Action; Display of CL=, RL=, or SL= is repeated. 

Operator Action; Type in correct allocation. 

SU08I DIRECTORY EXCEEDS LIBRARY 

Ca us e: The number of tracks allocated to a directory exceeds the 
total number of cylinders allocated to directcry+library . 

System Action; Display of CL=, RL=, or SL= is repeated. 

Operator Action : Type in correct allocations. 

S418I DIRECTORY IS FULL 

Cause; The specified directory does net have enough space tc 
catalog. 

S yste m Action; The job is canceled. 

Operator Action; Resubmit the job and provide larger directory 
allocations. 

34191 LIBRARY IS FULL 

Cause; The specified library does not have enough space to 
catalog. 

System Action ; The job is canceled. 

Operator Action ; Resubmit the job and provide a larger library 
allocation. 

SU202 EOV ENCOUNTERED 

S421A MOUNT NEW TAPE AND GIVE EOB IF UNIT IS READY 

Caus e; End of volume was reached while reading from SYS 006. 

System Action; The system waits for another volume to be mounted 
and readied. 

Operator Action ; Mount another tape volume and press the END or 
ENTER key. 

SU22I WRONG TAPE VOLUME 

Caus e: Wrong volume sequence number encountered. 

S ystem Action; The tape is rewound and unloaded, then message 
S421A MOUNT NEW TAPE AND GIVE EOB IF UNIT IS READY is displayed. 

Operator Action: Mount another tape volume and press the END or 
ENTER key. 

S423I WRONG DESCRIPTOR, xxx? INSTEAD OF xxxx 

Cause: A data check occurred on SYS 006. 
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System Acti9n; The job is canceled. 

Operator Action: Rerun the job (the tape unit may need 
servicing) . 

34241 WRONG TAPE RECORD COMPCNENT=xxxxxxxxxx 

Cause ; A data check occurred on SYS 006. 

System Action; The job is canceled. 

Operator 'Action; Rerun the job (the tape unit may need 
servicing) . 

S425I BLOCK COUNT ERROR 

Cause; A data check occurred on SYS 006. 

System Action: The jcb is canceled. 

Operator Action ; Rerun the job (the tape unit may need 
servicing) . 

S426I NO VOLl LABEL FOUND 

Cause; No VOLl label was found at cylinder 0, head 0, reccrd 3 
of the disk device assigned to SYS005. 

S ystem Action: The job is canceled. 

Operator Ac tion : 

• Check the device assignment for SYS005. 

• Check whether the correct disk pack has been mounted. 

If correction is necessary, rerun the restore program. 

If no correction is necessary, initialize the disk and rerun the 

restore program. 

S427I NO FORMAT 4 LABEL FOUND 

Cause: Record found at address specified in VOLl lable is net a 
Format 4 label. 

System Action; The job is canceled^ 

Operator Action: Initialize the disk, then rerun the restore 
program. 

S428I INVALID DEVICE TYPE 

Cause; The device assigned to SYS005 is not a valid disk drive. 

Sys tem A ction; The job is canceled. 

Operat or Action ; Repeat the restore procedure with a corrected 
assignment for SYS 005. 



120 DOS/VS System Generation 



4291 EXTENT EXCEEDS PACK LIMITS 

Cause; Total number of cylinders allocated exceeds capacity of 
disk pack. 

System Action; Display of CL=, RL=, or SL= is repeated. 

Operator Action; Type in correct allocations. 

SU30I OVERLAP ON VTOC 

Cause; VTOC address was found to be tco low. 
System Action; The job is cancelled 
Operator Action ; 

• Reinitialize the disk with the VTOC on a higher disk address, 
or 

• Resubmit the job with smaller allccations. 

S431I EQUAL FILE IN VTOC 

U4-byte file-id. 
SU32D TYPE DELETE OR GIVE A NEW FILE ID 

Cause; The 44-byte file-id under which SYSRES is to be restored 
already exists as an unexpired Format 1 label in the VTOC. 

System Ac tion ; The system waits for an operator response. 

Operator Acti on : 

• Type DELETE to delete the unexpired file, or 

• Type a new file-id (both upper and lower case are accepted) . 

S433D TYPE GO IF FILE ID IS CORRECT 

Cause; System response to previously displayed message. 
System Action; The system waits for an operator response. 
Operator Action : 

• Type GO if file-id was entered correctly, or 

• Press the END or ENTER key if it was not. 

S43UI OVERLAP ON UNEXPIRED FILE 

44-byte file-id. 
SU35D TYPE CANCEL, DELETE OR RETRY 

Cause; The extent card limits overlap the extent limits of an 
unexpired file. 

System Action; The system waits for an operator response. 

Operator Action; 

• Type CANCEL to cancel the job, or 



DOS/VS Distribution Program Messages 121 



• Type DELETE to delete the unexpired file, or 

• Type RETRY, then provide different allocations. 

S436D INVALID RESPONSE 

Cause; Operator response to previously displayed iressage is 
invalid. 

System Action: The system waits for an operator response. 

Operator Action; Type in correct response to previous message. 

S437I NO LABEL SPACE IN VTOC FOR A NEW FILE LAEEL 

Cause; No space available in the VTOC to write a new label. 

System Action; The job is canceled. 

Opera tor Action : Initialize a disk pack with a larger VTOC, then 
copy the pack being processed onto that pack and rerun the job. 

S438I JOB CANCELED 

Cause; This message is displayed directly after a message which 
indicates the reason why abnormal end-of-job was reached. 

System Action : The system enters the wait state. 

Operat or Action ; Resubmit the job, after having resolved the 
error condition (s) . 

S439I END OF JOB 

Cause; Normal end of job. 

Syste m Action ; The system enters the wait state. 

O pera t or Acti on ; Proceed with the next step of your system 
generation. 
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IBM 2314 Direct Access Storage Facility Example 

Figure 1-13 illustrates the general procedure to be followed by users with 
a 2314 available. 
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Figure 1-13. PROCEDURES — Overview of a 2314 Systerr Generation 
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This example is one of the irany possible methods for generating a system, 
Figure 1-14 illustrates the system configuration upon which the 2311 
Example is based. 



INPUT/OUTPUT DEVICE CONFIGURATION FOR 2314 EXAMPLE (SEE FIGURE l-iq) 

Use 

Card Reader (SYSRDR, SYSIPT) 

Card Punch (SYSPCH) 

Printer (SYSLST) 

Console Printer-Keyboard (SYSLOG) 

Disk (SYSRES, SYSLNK, SYSREC , SYSOOl, 
SYS002, SYS003) 

Magnetic Tape 



Device 


Channel 


Unit 


3505 





oc 


3525P 





CD 


3211 





OE 


3210/3215 





IF 


2314 


1 


30 


3420T9 


2 


80 



2^14 Example: Results of System Generation 

when system generation is completed, the operational disk of the 
installation contains user selected components and programs in its cere 
image library, together with the installation's tailored supervisor, job 
control, linkage editor, and librarian programs. The tape shipped by IBM 
is retained as backup tape. It is a self-loading tape capable of being 
restored on disk. Libraries contain all phases, modules, and macro 
definitions shipped from IBM. The core image library is built to contain 
those IBM programs chosen. 

The core image, relocatable, and source statement libraries are 
condensed, and IOCS modules are assembled and cataloged to the relocatable 
library. 
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Figure 1-14. PROCEDURES--System Configuration for 2314 Example 
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Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 

IBM 2314/2319 NON-TAPE USERS 

These users receive the 2314 system on a 2316 disk pack. This IBM-supplied 
pack consists of a core image library, a relocatable library, a source 

statement library, and a procedure library. 

• Mount the IBM-supplied vclurr^e and proceed to Step 3. 



IBM 2314/2319 AND TAPE USERS 

These users with at least one tape unit available receive the 2314 system 
on magnetic tape (see Figure 1-10 for distributions). This IBM-supplied 
tape is capable of restoring the 2314 system to a 2316 disk pack. After 
the tape has been restored to the 2316 disk pack, the pack contains a core 
image library, a relocatable library, a source statem.ent library, 
and a procedure library. 

Step 1 

Mount the IBM-supplied magnetic tape and a disk pack to vihich the tape is 
to be restored. 

Before restoring the tape, you must take the necessary action to perforir 
or bypass the initialize disk routine. 

a. If the disk pack has not been initialized, the IBM-supplied volume, a 
self-loading tape, is capable of initializing the packs. Any volume 
serial number used in the EXTENT cards for the following steps must 
agree with the volume serial number of the disk pack. 

If initialization is required, mount a pack on unit 130. Mount the 
IBM-supplied tape on unit 280 (9-track drive). Place the following 
cards in the card reader. ipL from unit 280. When the system enters 
the wait state, press START and EOF on the card reader. 



// JOB INTDSK 

// ASSGN SYSLOS,X'01F' ,C1 

// LOG (optional) 

// ASSGN SYSLST,X*00E' ,L1 (optional) 

// DATE 11/30/73 

// ASSGN SYSOPT,X'130' ,D3 

// EXEC 

// UID lA 

// VTOC STRrADR= (0199000), EXTENT=( 20) 

VOLlllllll 

// END 



b. If the disk pack was previously initialized, the initialize disk 

routine can be bypassed. Any volume serial number used in the EXTENT 
cards for the following steps must agree with the volume serial number 
used when the packs were initialized. 

To bypass the initialize disk program on the IBM-supplied tape, mount 
the IBM-supplied tape on unit 280 (9-track drive), and mount an 
initialized disk on unit 130 (VTOC on CYL 199). If the VTOC is not on 
cylinder 199, you can get it there by using the 'IS* option (see 
section "Initializing the Disk"). Insert the following control cards 
in the reader. IPL from unit 280. When the system enters the wait 
stata, press START and EOF on the card reader. The job is complete 
when message S130A (Intervention Required) is issued, to which you 
need not reply. 
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p 

|// JOB INIDSK 

I // hSSGi^ SySL03,X'OlF',Cl 

|// DATE 11/30/73 

I // FILES SYSIPT,1 

L_ 



Step 2 

After step 1 is completed, you must restore the system from the 
self-loading tapes to the initialized pack. 

Do not rewind unit 280. To restore the tape on disk, place the 
following cards in the reader. IPL from unit 280. When the system enters 
the wait state, press START and EOF on the card reader. See "Restore the 
IBM-Supplied System Tape to Disk" for operating procedures. 

At this point you have the option to allocate library sizes that are 
larger than the default values. Choosing your own values rather than the 
default values may save you a time-consuming reallocation later in the 
procedure. 



J. . . 

|// JOB DISRST 

|// ASSGN SYSLOG,X'01F',C1 

|// DATE 11/30/73 

|// ASSGN SYS005,X'130',D3 

|// ASSGN SYS006,X'280',T2 

\// ASSGN SYSLST,X' OOE' ,L1 

|// EXEC 



when the tape is restored, IPL from unit 130 to pass control to the DOS/VS 
supervisor. The IPL program will request a supervisor name. Depress the 
LOAD key on the CPU control panel; the system enters the wait state. The 
supervisor name can now be entered from ttie console printer-keyboard or 
read in from the card reader. 

Osingthe Console Printer- Keyboar d 

Depress the REQUEST key on the console printer-keyboard; 

Type in $$A$SUP1 or depress the END or ENTER key and the default $$A$SUP1 
will be taken. The system enters the wait state to enable you to enter 
yf^nr I/O device specific^itionc. This can be done by typing them in on the 
console printer-keyboard or by using the card reader, as in this example. 
Proceed to section "Entering your I/O Device Specifications" . 

n§i B3._ t he car d reader 

A card must be punched, beginning in column 1, containing the supervisor 

name $$A$SUP1. This card is to precede the IPL deck. 

When the system enters the wait state, start the card reader by depresssing 

the START and EOF keys. After the first card has been read, stop the card 

reader. 

Entering your I/O Device Speci ficatio ns 

The IBM-supplied supervisor contains no I/O device specifications. 
Therefore, you must provide IPL ADD commands for all I/O devices to be used 
and ASSGN commands or statements for all system and programmer I/O 
assignments required. How to use the IPL commands is described in Chapter 

126 DOS/VS System Generation 



4: "Starting the System" of the DOS / VS Systeir, Mana qe irent G u ide. The 
formats of these commands are contained in DOS/VS Sy steir Control Stat eiients 
and in DOS/VS Operating P rocedure s. When the system enters the wait state, 
press START and EOF on the card reader. The fcllowing cards are in the 
card reader (SYSRDR/SYSIPT) : 



JADD X'OOC ,3505 

I ADD X*00D',3525 

I ADD X*00E*,3211 

I ADD X*01F*,1050A 

|ADD X'130',2314 

I ADD X'280' ,3U20T9 

I SET DATE=11/30/73,CLOCK=12/00/00 (see Note) 

JDPD TYPE=F,UNIT=X'130',CYL=190 

JASSGN SYSLOG,X*01F» 

I LOG 

JASSGN SYSRDR, X'OOC* 

JASSGN SYSIPT, X'OOC 

JASSGN SYSPCH,X*OOD« 

lASSGN SYSLST,X'0OE* 

lASSGN SYS001,X'130* 

lASSGN SYS002,X*130* 

lASSGN SYS 03, X' 130* 

JASSGN SYSLNK,X'130* 

JASSGN SYSREC,X'130* 

I SET RF=CREATE 



Note ; The IBM-supplied supervisor does not contain the supervisor 
generation option TOD=YES. Refer to DOS/VS Operat i n g Pr oced ures , GC33-5371 
for more information on IPL procedures. 

For more information on the IPL DPD comirand and the jcb control SET 
command refer to the section entitled "Creating System Files". 



Step U 



Define label information for SYSRES, SYSLNK, SYSOOl, SYS002, SYS003, and 
SYSREC. 



|// OPTION STDLABEL 

j// DLBL IJSYSRS,'DOS SYSRES. FILE ', 99/365, SD 

|// EXTENT SYSRES, nnnnnn,l,n, 00 01, nnnn 

|// DLBL I JSYSLN, 'SYSTEM WORK FILE NO. 0',99/3 65,SD 

j // EXTENT SYSLNK, nnnnnn,l,n, nnnn, nnnn 

|// DLBL IJSYS01,*SYSTEM WORK FILE NO. 1', 99/365, SD 

j// EXTENT SYS 001, nnnnnn,l,n, nnnn, nnnn 

|// DLBL IJSYS02, 'SYSTEM WORK FILE NO. 2', 99/365, SD 

[// EXTENT SYS002,nnnnnn,l,n,nnnn,nnnn 

j// DLBL IJSYS03, 'SYSTEM WORK FILE NO. 3',99/365,SD 

|// EXTENT SYS003,nnnnnn,l,n,nnnn,nnnn 

j// DLBL I JSYSRC, 'SYSTEM RECORDER FILE ', 99/365 ,SD 

|// EXTENT SYSREC, nnnnnn,l,n, nnnn, nnnn 

|/& 
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step 5 



Perform a diagnostic assembly of the Installation Verification Procedure 
(IVP) by specifying VERIFY=YES in the IVPGEN macro. In the same run^ a job 
can be generated to delete any unused IVP books from the system source 
statement library. Refer to Module 3: "Installation Verification 
Procedure" for a comprehensive description of the IVPGEN parameters. 



j// JOB IVP DIAGNOSTICS 

|// EXEC ASSEMBLY 

i IVPGEN VERIFY=YES, [DELUNDS=YES,] selected IVPGEN parameters 

I END 

j/* 

I // PAUSE remove last card punched; put deck before other cards in hopper 

I (see note, which follows) 

|/g 

L , 



Note; Omit the // PAUSE statement if no delete job is tc be generated. 

Step 6 

Perform a sorted DSERV to display the directories for later reference. 
Four books in the source statement library should be punched out at this 
time (Z^LINKEDIT, Z.DELETECL, Z.DELETERL, and Z.DELETESL). They contain 
the necessary control statements to selectively linkage edit and delete all 
IBM components. 



|// JOB DSERV 

j// EXEC DSERV 

I DSPLYS ALL 

|/* 

|// EXEC SSERV 

I DSPCH Z.LINKEDIT,Z.DELETECL,Z.DELETERL, Z.DELETESL 

|/* 

|/g 

L : « 



Step 7 



Delete never-to-be-used components from the relocatable and source 
statement libraries by using the three delete books punched out in the 
previous step. 

J. . — ^ 

// JOB DELETE 

// EXEC MAINT 
DELETC (Unwanted Core Image Library Components) 
DELETR (Unwanted Relocatable Library Components) 
DELETS (Unwanted Source Statement Library Components) 

/♦ 

/& 

L J 
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step 8 



Assemble the installation tailored supervisor. 

r — n 

// JOB SUPVR 

// EXEC ASSEMBLY 

SUPVR NPARTS=4,P0WER=YES 

CONFG MODEL=145,FP=YES 

STDJC LISTX=YES,LINES=46 

FOPT RELLDR=YES,IT=YES,PC=YES,OC=YES,SKSEP=YES,CBF=10, X 
AB=YES,DASDFP= (1,1, 2314) ,SYSFIL=YES,TOD=YES , X 

Z0NE=(WEST,5) 

PIOCS 

VSTAB RSIZE=160K,VSIZE=U80K 

ALLOC F1=64K,F2=64K,F3=128K 

ALLOCR F3R=22K,F2R=2 8K 

lOTAB JIB=20,F1PGR=8,F2PGR=8,IODEV=2 0,BGPGR=10,D2314=6,D3U20=2 

DVCGEN CHUN=X»00C',DVCTYF=35 05 



DVCTYP=3525P 

DVCTYF=3211 

DVCTYP=1050A 

DVCTYP=2314 

DVCTYP=23m 

DVCTYF=2314 

DVCTYP=2314 

DVCTYP=2314 

DVCTYP=2314 

DVCTYP=3420T9 

DVCTYP=3U20T9 



DVCGEN CHUN=X*OOD» 
DVCGEN CHUN=X»OOE» 
DVCGEN CHUN=X*01F' 
DVCGEN CHUN=X»130V 
DVCGEN CHUN=X*131' 
DVCGEN CHON=X'132' 
DVCGEN CHUN=X*133« 
DVCGEN CHUN=X • 1 3 4 * 
DVCGEN CHUN=X*135» 
DVCGEN CHUN=X'280r 
DVCGEN CHUN=X'281' 
ASSGN SYSRDR,X* OOC 
ASSGN SYSIPT,X'OOC 
ASSGN SYSPCH,X' OOD' 
ASSGN SYSLST,X'OOE 
ASSGN SYSLOG,X'01F' 
ASSGN SYSLNK,X'130' 
ASSGN SYSREC,X*130' 
ASSGN SYS001,X*130' 
ASSGN SYS002,X'130' 
ASSGN SYS003,X'130 
DPD CYL=194,UNIT=X" 
SEND 
END 
/* 

♦ CHECK ASSEMBLY LISTING FOR ERRORS. IF CORRECT 

♦ REMOVE ASSEMBLED SUPERVISOR FROM SYSPCH. INSERT IN READER 

♦ FOLLOWING THE INCLUDE CARD OF JOB CATALSUP 
// PAUSE TO CONTINUE PRESS END 

/& 



130*,VOLID=111111 



Step 9 

Link-edit and catalog the 
to the core image library. 
m acrOy is larger tha n the 
certai n _k e ^_E^ograms must 



assembled supervisor (object module from step 8) 

If the RSI Z E value, specified by the VSTAB 
one use d b y the supervisor being replac ed, 
also be li nk-edited a nd ca talog e d to the core 



image library in the; s am e j ob st ep with the new supervisor. T h es e key 



prog rams a re th e libr aria 

LINKEDIT deck punched out 

I statements to link-edit a 



n programs C ORGZ, RSERV, SSERV, a nd PSERV . The 

in step 6 contains all the necessary control 
11 IBM components shipped on the system. 



Note: It may be necessary to reallocate because of the size of the 
programs (components) desired in the libraries. This may be accomplished 
by using the ALLOC statement of either the MAINT or CORGZ librarian 
programs. 
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// JOB CATALSUP 

// OPTION CATAL 

ACTION CLEAR 

INCLUDE 

Supervisor object deck here, 
/* 

// EXEC LINKEDT 
/g 



Step 10 

Re-IPL and format your new page data set, using the DPD coinniand, including 
TYPE=F. Procedure SDL (System Directory List) or, for VSAM users procedure 
IKQVPSVA, is executed to improve performance (for more information on these 
procedures see the introduction to this manual). If you do not wish tc 
retain a procedure library, you should punch the procedure into cards, 
using the PSERV prograir, and include the card deck in your IPL procedure. 



Example ; 



ADD commands 
SET DATE etc. 
DPD options 
SET SDL=CREATE 
phase name 



/* 

Assign commands 
SET RF=CREATE 

The procedures SDL and IKQVPSVA or the comirand SET SDL=CREATE must precede 
job control commands such as ASSGN. These procedures can only be executed 
in a raultipartition environment (NFARTS>1) . 

When IPL is complete, enter the SET job control command. If you desire 
a recorder file different from the one that was allocated on your first IPL 
(step 3), include RF=CREATE in the SET command. For more information en 
these procedures, refer to the section entitled "Creating System Files". 



// JOB CATALSRV 
// OPTION CATAL 

INCLUDE IJBSL3 RSERV 

// EXEC LNKEDT 

INCLUDE IJESL^V SSERv 

// EXEC LNKEDT 

INCLUDE IJBSL5 CORGZ 

// EXEC LNKEDT 

INCLUDE IJBSL6 PSERV 

// EXEC LNKEDT 

PHASE LSERV,+0 

INCLUDE IJBLSERV 
// EXEC LNKEDT 

// PAUSE CHECK SYSLST OUTPUT 
/6 



Link-edit and catalog any additional components desired to the core 
image library. See the appropriate module for each component for a 
complete list of control cards for the components to be cataloged. 
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step 11 

Perforin an assembly of the Installation Ve 
contrast to Step 5 the IVPGEN iracrc must n 
VERIFY=NO (VERIFY=YES causes suppression o 
stream). The output consists of a jobstre 
functions. Output is on SYSPCH which can 
a disk drive. You can also generate a job 
were used in the assembly. If you would c 
in mind that it will be impossible to do a 
during this system generation. 



rification Procedure. In 

cw be asseirbled with cpticn 

f the generation of the IVP job 

am to execute the selected IVP 

be a card punch, a tape drive, or 

that deletes the IVP bocks that 
hoose to do this, however, bear 

reassembly of the IVPGEN iracrc 



Refer to Module 3 "Installation Verification Procedure" for a 
comprehensive description of the operating instructions for IVP. 

r 1 

// JOB IVP GENERATION 
// EXEC ASSEMBLY 

IVPGEN VERIFY=NO, [DELUSED=YES,] selected IVPGEN parameters 

END 

/* 

// PAUSE remove last card; put deck before other cards in hopper 

L J 



Step 12 

Perform all other necessary assemblies. The component assemblies should be 
performed as separate jobs. Bear in mind that A-library macros such as, 
for instance, program products supplied in A-macro format, must be edited 
before they can be assembled. For the information required to assemble 
Emulator Programs, refer to the Emulat or Program manual listed in the 
Preface. You must be careful to keep all assemblies in order. Assemble 
all your required IOCS modules. Ey assigning SYSPCH to a tape or disk 
unit, the IOCS modules can be cataloged to the relocatable library without 
punching them on cards. The IOCS modules required by compilers, as defined 
in Module 7, "Compiler IOCS Modules", are supplied in the relocatable 
library by IBM. 

Close the tape assigned to SYSPCH and reassign SYSPCH to its permanent 
assignment by using the CLOSE command. The assembly listings should be 
checked for errors before proceeding. 



|// JOB ASSEM 

|// OPTION DECK, LIST, LOG 

|// ASSGN SYSPCH, X* 280' 

j// EXEC ASSEMBLY 

I CDMOD RECF0RM=FIXUNB,CTLCHR=ASA„TYPEFLE=0UTPUT,I0AREA2=YES, X 

I DEVICE=3525,SEPASMB=YES 

i END 

|/* 

j// EXEC ASSEMBLY 

I MTMOD RECFORM=FIXUNB,READ=FORWARD,CKPTREC=YES,SEPASME=YES 

I END 

j/* 

1 CLOSE SYSPCH, X'OOD* 

|/& 

I* CHECK ASSEMBLY LISTINGS FOR ERRORS. RELOAD 280 WITH SAME TAPE. 

j// PAUSE IF CORRECT PRESS END TO CONTINUE. 

L ^ 

The multipart forms of the linkage editor maps and the supervisor listing 
will be required by your IBM customer engineer for maintenance purposes. 
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Before the next step is perfcrired, perform an LSERV to display the label 
cylinder, check the linkage editor listings, and make all necessary 
corrections. 

Step 13 

Reload the tape that was assigned to SYSPCH in step 12 and assign it to 
SYSIPT. With this tape the MAINT program catalogs the IOCS modules to the 
relocatable library by the control card // EXEC MAINT. 

r *- ■ -,^======-=— ^.^ ^ 

|// JOB CATALRLB 

j// ASSGN SYSIPT, X'280' 

I* CATALOG MODULES TO RELOCATABLE LIBRARY 

j// EXEC MAINT 

|/* 

|/6 

L , J 

When planning your compilers and cataloging their on the system, also 
plan the "procedures" to catalog for using the compilers in various 
partitions. 

Example: 

// JOB CATAL PROC 
// EXEC MAINT 

CATALP F2RPGII 
// JOB 124 

// ASSGN SYS001,X'160' 
// ASSGN SYS002,X'160' 
// ASSGN SYS003,X'160' 
ASSGN SYSCLB,UA 
ASSGN SYSRLB,UA 
ASSGN SYSSLB,UA 
// OPTION LINK, LIST, NODECK 
// EXEC RPGII 
/ + 

Calling statements for frequently used DOS/VS service programs, sorts, and 
utilities should be cataloged at this time also. 

Example: 

// JOB CATAL PROC 
// EXEC MAINT 

CATALP DITTO 
// JOB DITTO 
ASSGN SYG029,X'180* 
ASSGN SYS028,X*181* 
ASSGN SYSCLB,UA 
// EXEC DITTO, REAL, SIZE=24K 
/+ 

The basic SYSGEN is complete. You may set new standard labels, 
re-allocate library sizes by using the copy function (CCRGZ) , condense the 
libraries, and set automatic condense limits if required. Copy the 
operational pack for backup. 

Note: A private core image library need not be on the same disk device 
type as SYSRES. However, this does not apply to other private libraries, 
which must reside on the same type of device as the SYSRES device. 
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IBM 3330/3340 Disk Storage Example 

Figure 1-15 illustrates the general procedure to be followed by users with 
I a 3330 or 33ao that is to be used as the svsteir residence volume. 
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I 



STEP lOj 

I 



Perform IVP 
procedure 
(VERIFY = No) 



Delete any 
used IVP 
books if not 
required later 



I 



"n 



Assemble 
l/o modules 



Link-edit 
desired com- 
ponents and 
perform an 
LSERV 



Catalog IOCS 
modules to 
relocatable 
library 



Reallocate 
& condense, 
if necessary 



Re-define 
standard 
labels, if 
required 



Copy new 
operational 
pack for 
back up 



___STEPJ_1 I I ?PfJLJ 



Of End of system \ 

I generation y 



Figure 1-15. 



PROCEDURES — Overview of a Systere Generation for Residence on 
a 3330 or 3340 Disk Storage 
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This example is one of the rran^ possible methods for generating. a system. 
Figure 1-16 illustrates the system configuration upon which the 3330/3340 
example is based. 



INPUT/OUTPUT DEVICE CONFIGURATION FOR 3330/3340 EXAMPLE (FIGURE 1-16) 



Use 



Device 


Channel 


Unit 


3505 





OC 


3525P 





OD 


3211 





OE 


3210/3215 





IF 


3330 or 3340 


2 


60 



3410T9 



80 



Card Reader (SYSRDR, SYSIFT) 

Card Punch (SYSFCH) 

Printer (SYSLST) 

Console Printer-Keyboard (SYSLOG) 

Disk (SYSRES, SYSLNK, SYSREC, 
SYSOOl, SYS002, SYS003) 

Magnetic Tape 



3330/3340 Example: Results ot System Generation 

When system generation is completed, the operational disk of the 
installation contains user selected components and programs in its core 
image library, together with the installation's tailored supervisor, jcb 
control, linkage editor, and librarian programs. The tape shipped by IBM 
is retained as backup tape. It is a self-lcading tape capable of being 
restored on disk. Libraries contain all modules and macro definitions 
shipped from IBM. The core image library is built to contain these IBM 
programs chosen. 

The core image, relocatable, and source statement libraries are 
condensed, and IOCS modules are assembled and cataloged to the relocatable 
library. 




Channel 1 



UnitX'180' 



IBM System/370 Model 145 

Optional Feature 
Floating Point 



Channel 2 



3330/ 
3340 



Unit X 260' 

SYSRES 

SYSVIS 

SYSLNK 

SYSOOl 

SYS002 

SYS003 

SYS R EC 













Channel 














UnitX'OIF. 
3215 ] 




Unit X'OOE' 






Unit X'OOC 


Unit X'OC 


3210/ 


3211 






• 

3505 






3525P 


SYSL 


OG 


L^^^-x — 




SYS 


RDR 






SYS 


PCH 



SYSLST SYSIPT 

Figure 1-16. PROCEDURES — System Configuration for 3 330/3340 Example 
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IlM_333 0_OnlY_Use£§ 

IBM 3330-only users receive the system on a 3336 disk pack.. This 
IBM-supplied pack consists of a core image library, a relocatable library, 
a source statement library, and a procedure library. 



Mount the IBM-supplied volume and proceed to Step 3. 



IgM-33ttO O nly Use rs 

IBM 3340-only users receive the system on a 3348 data module. This module 
consists of a core image library, a relocatable library, a source 
statement library, and a procedure library. 

• Mount the IBM- supplied volume and proceed to Step 3. 



IlM-3330/3 3 40 and Tape Users 

IBM 3330/3340 and tape users receive the system on magnetic tape (see 
Figure 1-16 for distributions). This IBM-supplied tape is capable of 
restoring the system to a 3336 disk pack or to either a 3348 Model 35 data 
module or a 3348 Model 70 data module. After the tape has been restored, 
the pack or data module contains a core image library, a relocatable 
library, a source statement library, and a procedure library. 

Before generating a system, you should have at least one initialized 
disk pack (VTOC on cylinder 403 for the 3336, on cylinder 347 for the 3348, 
Model 35„ and on cylinder 695 for the 3348 , Model 70) . 



Step 1 

Mount the IBM- supplied magnetic tape and the disk volume to which the tape 
is to be restored. 

Before restoring the tape, you must take the necessary action to perform 
the initialize disk routine or to bypass it. 

a. If the disk volume has not been initialized, the IBM-supplied volume, a 
self-loading tape, is capable of initializing the volumes. The volume 
serial number used in the EXTENT cards for the following steps must 
agree with the volume serial number of the disk volume. 

If initialization is required, mount a volume on unit 26 0. Mount 
the IBM-supplied tape on unit 180 (9-track drive). Place the following 
cards in the card reader. IPL from unit 180. When the system enters 
the wait state, press START and EOF on the card reader. 
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// JOB INTDSK 

// ASSGN SYSLOG,X'01F' ,C1 

// DATE 11/30/73 

// LOG (optional) 

// A.SSGN SySLST,X*OOE» ,L1 

// ASSGN SZSOPT,X'260' ,D4 

// EXEC 

// aiD IQ 

// VTOC STRTADR=(CCCCCCC) ,EXTENT=(tt) 

VOLlllllll 

// END 



(optional) 

(D5 or D6 if 3348) 



(See Note) 



Note; ccccccc=0403000 for a 3336 disk pack 

=0347000 for a 3348 data module, model 35 
=0695000 for a 3348 data module, model 70 
tt=19 for a 3336 disk pack 

=12 for a 3348 data module, model 35 
=12 for a 3348 data module, model 70 

b. If tha disk volume was previously initialized, the initialize disk 

routine can be bypassed. Any volume serial number used in the EXTENT 
cards for the following steps must agree with the volume serial number 
used when the volumes were initialized. 

To bypass the initialize disk program on the IBM-supplied tape, 
mount the IBM-supplied tape on unit 18 (9-track drive) , and mount an 
initialized disk on unit 260 (VTOC on CYL 403 for the 3336, cylinder 
347 for the 3348, Model 35, and cylinder 695 for the 3348, Model 70).. 
Insert the following control cards in the reader. '*Tf^t~§*tM~TJhxt^VG^^ ^ 
When the system enters the wait state, press START and EOF on the card 
reader. The job is complete when message S130A (Intervention Required) 
is issued to which you need not reply. 



J. ^ 

|// JOB INTDSK 

|// ASSGN SYSLOG,X'01F',C1 

|// DATE 11/30/73 

|// ASSGN SYSIPT,X'180',T2 

|// FILES SYSIPT,! 

L 



Step 2 

After step i is completed, you must restore the system from the 
self-loading tapes to the initialized pack. 

Do not rewind unit 180. To rest ore th e tape on disk, place the 
follov7ing cards in the reader. :^3C>5!?S5r'2ffii4r'ir®, . When the system enters 
the wait state, press START and '^f on the card reader. See "Restore the 
IBM-supplied System Tape to Disk" for operating procedures. 



|// JOB DISRST 

|// ASSGN SYSLOG,X'01F' ,C1 

j// DATE 11/30/73 

I// ASSGN SYS005,X'260' ,D4 

|// ASSGN SYS006,X'180' ,T2 

|// ASSGN SYSLST,X*00E',L1 

I // EXEC 

L 



(D5 or D6 if a 3348 
data module is used) 
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step 3 

When the tape is restored, IPL from unit 260 to pass control to the DOS/VS 
supervisor. The IPL program will request a supervisor name. Depress the 
LOAD key on the CPD control panel; the system enters the wait state. The 
supervisor name can now be entered from the console printer-keyboard or 
read in from the card reader. 

Using the Console Printer- Keyboard 

Depress the REQUEST key on the console printer-keyboard; 

Type in $$A$SUP1 or depress the END or ENTER key and the default $$A$SUP1 
will be taken. The system enters the wait state to enable you to enter 
your I/O device specifications. This can be done by typing them in on the 
console printer-keyboard, or by using the card reader, as in this example. 
Proceed to section "Entering your I/O Device Specifications" . 



A card must be punched, beginning in column 1„ containing the supervisor 
name $$A$SUP1. This card is to precede the IPL deck. 



Using the card reader 

A card must be punchec 

name $$A$SUP1. This c^^^ ^^ ,,w ^^^^.^^^ ^^^^ ^^ju ^^^i^. 

When the system enters the wait state, start the card reader by depressing 

the START and EOF keys. After the first card has been read, stop the card 

reader. 

The IBIVI- supplied supervisor contains no I/O device specifications. 
Therefore, you must provide IPL ADD commands for all I/O devices to be used 
and ASSGN commands or statements for all system and programmer I/O 
assignments required. How to use the IPL commands is described in Chapter 
4: "Starting the System" of the DOS/VS System Management 3uid e. The 
formats of these commands are contained in DOS/VS System Con trol Statements 
and in DOS/VS Operating Procedures. When the system enters the wait state, 
depress START and EOF on the card reader. The fcllowing cards are in the 
card reader (SYSRDR/SYSIPT) : 



r ■ 

jADD X'OOC ,3505 

I ADD X'OOD' ,3525P 

I ADD X'OOE',3211 

I ADD X'01F',1050A 

I ADD X' 260' , (device type)* 

I ADD X'180',3410T9 

I SET DATE=11/30/73,CLOCK=12/00/00 (See Note 1) 

|DPD TYPE=F,UNIT=X'260',CYL=390 

I ASSGN SYSLOG,X«01F' 

I LOG 

I ASSGN SYSRDR,X" OOC* 

1 ASSGN SYSIPT,X'OOC' 

I ASSGN SYSPCH, X'OOD* 

I ASSGN SYSLST,X'OOE' 

I ASSGN SYS001,X'260' 

I ASSGN SYS002,X'260' 

I ASSGN SYS003,X'260"' 

I ASSGN SYSLNK,X'260' 

I ASSGN SYSREC,X'260* 

I SET RF=CREATE (See Note 2) 

L J 

♦device type = 3330 or 3340 
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Notes : 

1. The IBM-supplied supervisor does not contain the supervisor generation 
option TOD=YES. Refer to DQS/VS Operating Procedures, GC33-5378, for 
more information on IPL procedures. 

2. If your CPU is a Model 115 or 125, the SET corriTiand must include the 
HC=CREATE operand. 

For more information on the IPL DPD command and the job control SET 
command,, refer to the section entitled "Creating System Files". 

Step U 

Define label information for SYSRES, SYSLNK, SYSREC, SYSOOl, SYS002, and 
SYS003. In addition you may include any label information required for 
your installation. 

^ -^ 

// OPTION STDLABEL 

// DLBL IJSYSRS,'DOS SYSRES . FILE ', 99/365 , SD 

// DLBL IJSYSLN, "SYSTEM WORK FILE NO. 0', 99/365, SD 

// EXTENT SYSLNK, nnnnnn, l,nnnnn,nnnn 

// DLBL IJSYSOl, 'SYSTEM WORK FILE NO. 1', 99/365, SD 

// EXTENT SYS 001, nnnnnn, l,nnnnn,nnnn 

// DLBL IJSYS 02, 'SYSTEM WORK FILE NO. 2', 99/365, SD 

// EXTENT SYS002, nnnnnn, l,nnnnn,nnnn 

// DLBL IJSYS03, 'SYSTEM WORK FILE NO. 3', 99/365, SD 

// EXTENT SYS 003, nnnnnn, l,nnnnn,nnnn 

// DLBL IJSYSRC,'DOS RECORDER FILE' , 99/365 ,SD 

// EXTENT SYSREC, nnnnnn, l,nnnnn,nnnn 

// DLBL IJSYSCN, 'HARDCOPY FILE' , 99/365 ,SD | hard copy file for 370/115 

// EXTENT SYSREC, nnnnnn, 1, nnnnnn, nnnn lor 370/125 

/& 



Step 5 

Perform a diagnostic assembly on the Installation Verification Procedure 
(IVP) by specifying VERIFY=YES in the IVpGEN macro. In the same run a job 
can be generated to delete any unused IVP books from the system source 
statement library. Refer to Module 3: "Installation Verification 
Procedure" for a comprehensive description of the IVPGEN parameters, 

^ ^ 

I // JOB IVP DIAGNOSTICS 
j // EXEC ASSEMBLY 

IVPGEN VERIFY=YES, [DELUNDS=YES,] selected IVPGEN parameters 

END 

/* 

// PAUSE remove last card punched; put deck before other cards 
in hopper (see note, which follows) 



Note: Omit the // PAUSE statement if no delete job is to be generated. 
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Step 6 

Perforin a sorted DSERV to display the directories for later reference. 
Four books in the source statement library should be punched out at this 
time (Z.LINKEDIT, Z.DELETECL, Z.DELETERL, and Z.DELETESL). They contain 
the necessary control statements to selectively link-edit and delete all 
IBM components. 



r 

I // JOB DSERV 

|// EXEC DSERV 

I DSPLYS fi.LL 

1/* 

|// EXEC SSERV 

I DSPCH Z.LINKEDIT,,Z.DELETECL, Z.DELETERL, Z.DELETESL 

j/* 

|/& 

L 



Step 7 

Delete components you will never use from the relocatable and source 
statement libraries by using the three delete books punched out in the 
previous step. You may consider condensing the libraries after this. 



J. . 

|// JOB DELETE 

j// EXEC MAINT 

I DELETC (Unwanted Core Image Library Components) 

j DELETR (Unwanted Relocatable Library Components) 

I DELETS (Unwanted Source Statement Library Coirpcnents) 

|/* 

|/& 

L__. 
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Step 8 



Assemble the installation tailored supervisor. 

^ ^ 

// JOB SUPVR 

// EXEC ASSEMBLY 

SUPVR NPARTS=3 , POWER=YES , TP=BTAM 
CONFG M0DEL=1U5,FP=YES 
STDJC LISTX=YES,LINES=46 

FOPT RELLDR=YES,PCIL=YES,PFIX=YES,IT=YES,PC=YES,OC=YES, X 
SKSEP=YES,CBF=10,AB=YES,DASDFP= (2,2,3330) , X 

SYSFIL=YES,TOD=YES, ZONE=(WEST, 5) 
PIOCS TAPE = 9,,DISK=3330 

VSTAB RSIZE=24(+K,VSIZE=426K,BUFSIZE=a8 
ALLOC F1=160K,F2=6UK 
ALLOCR BGR=6 0K,F1R=30K,F2R=3 0K 

lOTAB JIB=20,F1PGR=8,F2PGR=8,IODEV=20,BGPGR=10,D3330=2,D3410=1 
DVCGEN CHUN=X'00C' ,DVCTYP=3505 

DVCTYP=3525P 

DVCTYP=3211 

DVCTYP=27 01 

DVCTYP=27 01 

DVCTYP=1050A 

DVCTYP=3410T9 

DVCTYP=3330 

DVCTYP=3330 



DVCGEN CHUN=X''00D' 
DVCGEN CHON=X'00E' 
DVCGEN CHUN=X'020' 
DVCGEN CHaN=X'021' 
DVCGEN CHUN=X'01F' 
DVCGEN CHUN=X*18 0' 
DVCGEN CHUN=X'2 60'' 
DVCGEN CHaN=X'261' 
ASSGN SYSRDR,X'00C 
ASSGN SySIPT,X' OOC 
ASSGN SYSPCH,X'OOD 
ASSGN SYSLST,X' OGE' 
ASSGN SYSLOG,X'01F 
ASSGN SYSLNK,X' 260' 
ASSGN SYS001,X'260 
ASSGN SYS002,X' 260' 
ASSGN SYS003,X'260 
ASSGN SYSREC,X' 26 0' 
DPD CYL=300,UNIT=X' 
SEND 
END 
/♦ 

* CHECK ASSEMBLY LISTING FOR ERRORS. IF CORRECT 

* REMOVE ASSEMBLED SUPERVISOR FROM SYSPCH. INSERT IN READER 

* FOLLOWING THE INCLUDE CARD OF JOE CATALSUP 
// PAUSE TO CONTINUE PRESS END 

/6 



260' ,V0LID=111111 



Note; Where an IBM 3340 Disk Storage is to be used instead of an IBM 3330, 
substitute the following specifications in the above example: 

FOPT DASDFP=( 2, 2,334 0) 

PIOCS DISK=3340 

lOTAB D3340=2 

DVCGEN DVCTYP=3340 

Step 9 

Link-edit and catalog the assembled supervisor (object module from step 8) 
to the core image library. If the RSIZE value, specified by the VSTAB 
macro, is larger than the one used by the supervisor being replaced, 
certain key programs must also be link-edited and cataloged to the core 
image library with the new supervisor. These key programs are the 
librarian programs CORGZ , RSERV, SSERV, and PSERV . The LINKEDIT deck 
punched out in step 6 contains all the necessary control statements 
to link-edit all IBM components shipped on the system. Do not 
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attempt any other operation from the time the supervisor and these 
preceding programs are cataloged until IPL time. 

Note; It may be necessary to reallocate the size of the libraries because 
of the size of the programs (components) desired in the various libraries. 
This may be accomplished by using the ALLOC statement of either the MAINT 
or CORGZ librarian programs. 

r T 

// JOB CATALSUP 

// OPTION CATAL 

ACTION CLEAR 

INCLUDE 

Supervisor object deck here. 
/* 

// EXEC LNKEDT 
/g 
L J 

Step 10 

Re-IPL and format your new page data set using the IPL DFD command 
including TYPE=F. Procedure SDL (System Directory List) or, for VSAM users 
procedure IKQVPSVA, is executed to improve performance (for more 
information on these procedures see the introduction to this manual) . If 
you do not wish to retain a procedure library, you should punch the 
procedure into cards, using the PSERV program, and include the card deck in 
your IPL procedure. 



ADD commands 
SET DATE etc. 
DPD options 
SET SDL=CREATE 
phase name 



/* 

Assign commands 
SET RF=CREATE 

The procedures SDL and IKQVPSVA or the command SET SDL=CREATE must precede 
job control commands such as ASSGN. These procedures can only be executed 
in a multipartition environment (NPARTS>1) . 



// JOB CATALSRV 
// OPTION CATAL 

INCLUDE IJBSL3 RSERV 
// EXEC LNKEDT 

INCLUDE IJESL4 SSERV 
// EXEC LNKEDT 

INCLUDE IJBSL5 CORGZ 
// EXEC LNKEDT 

INCLUDE IJBSL6 PSERV 
// EXEC LNKEDT 

PHASE LSERV,+0 

INCLUDE IJBLSERV 
// EXEC LNKEDT 

// PAUSE CHECK SYSLST OUTPUT 
/g 
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When IPL is complete, enter the SET job control coirirand. If you desire 
a recorder file different from the one that was allocated on your first IPL 
(step 3), include RF=CREATE in the SET comirand. 

If your CPU is a Model 115 or 125 and you desire a hard-copy file 
different from the one that was allocated on your first IPL (step 3), 
include HC=CREATE in the SET coirirand. For iriore inforiration on these 
procedures, refer to the section entitled "Creating System Files". 

Link-edit and catalog any additional components desired to the core 
image library. See the appropriate module for each coirpcnent for a 
complete list of control cards for the components to be cataloged. 

Step 11 

Perform an assembly of the Installation Verification Procedure = In 
contrast to Step 5 the IVPGEN macro must now be assembled with option 
VERIFY=NO (VERIFY=YES causes suppression of the generation of the IVP 
jobstream) . The output consists of a jobstream to execute the selected IVP 
functions. Output is on SYSPCH which can be a card punch, a tape drive, or 
a disk drive. You can also generate a job that deletes the IVP bocks that 
were used in the assembly. If you choose to do this, however, bear in mind 
that it will be impossible to do a reassembly of the IVPGEN macro during 
this system generation. Refer to Module 3 "Installation Verification 
Procedure" for a comprehensive description of the operationg instructions 
for IVP. 

r ' " 1 

|// JOB IVP GENERATION 

j// EXEC ASSEMBLY 

j IVPGEN VERIFYING,, [DELUSED=YES,] selected IVPGEN parameters 

I END 

I // PAUSE remove last card punched; put deck before other cards in hcpper 

|/6 

L . 



Step 12 

Perform all other necessary assemblies. Bear in mind that A-library macros 
such as, for instance, program products supplied in A-macro format, must be 
edited before they can be assembled. The ccmpcnent assemblies should be 
performed as separate jobs. For the information required to assemble 
Emulator Programs, refer to the Emu l a tor Program manual listed in the 
Preface. You must be careful to keep all assemblies in order. Assemble 
all your required IOCS modules e By assigning SYSPCH to a tape unit, the 
IOCS modules can be cataloged to the relocatable library without punching 
them in cards. The IOCS modules required by compilers, as defined in 
Module 7, "Compiler IOCS Modules"- are supplied in the relocatable library 
by IBM. 

Close the tape assigned to SYSPCH and reassign SYSPCH to its permanent 
assignment by using the CLOSE command. The assem.bly listings should be 
checked for errors before proceeding. 
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// JOB ASSEM 
// OPTION DECK,, LIST, LOG 
// ASSGN SYSPCH,X"180' 
// EXEC ASSEMBLY 

CDMOD RECFORM=FIXUNB , CTLCHR=ASA, T YPEFLE=OUTPUT , I0AREA2=YES , 
DEVICE=3 525, SEPASMB=YES 
END 
/* 

CLOSE SYSPCH,X*OOD* 
/& 

* CHECK ASSEMBLY LISTINGS FOR ERRORS. RELOAD 180 WITH SAME TAPE. 
// PAUSE IF CORRECT PRESS END TO CONTINUE. 



The multipart forms of the linkage editor maps and the supervisor listing 
will be required by your IBM customer engineer for maintenance purposes. 

Before the next step is performed, check the linkage editor listings, and 
make all necessary corrections. 

Step 13 

Reload the tape that was assigned to SYSPCH in step 12 and assign it to 
SYSIPT. With this tape the MAINT program catalogs the IOCS modules to the 
relocatable library by the control card // EXEC MAINT. 



|// JOB CATALRLB 

|// ASSGN SYSIPT, X'lBO" 

I* CATALOG MODULES TO RELOCATABLE LIBRARY 

J// EXEC MAINT 

)/♦ 

|/& 

L 



The basic SYSGEN is complete. You may set new standard labels, 
re-allocate library sizes by using the copy function (CORGZ) , condense the 
libraries, and set automatic condense limits if required. Copy the 
operational pack for back-up. 
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Component 



IBM 

PrograiTi 
Number 
5745-SC 



4 



Part 
Size 
Bytes 



Core Image Library 



Phases 



Blocks 



Relocatable 

Library 



Prefix Blocks 
Modules 



Source State 
iTient Library 



Books Blocks 



At tention Routines^ 

Initiators,, 
Terminators S Dumps 



AIT 
(Note 



1) 



Standard System Dump 

Translating System 

Dump 

Attention Routines,, 

Initiators, 

Terminators 



9* 
9* 



33* 



11 
11 



39 



IJB 10 58 
IJB 10 59 



-+ 



Assembler £ ESERV 
Programs. 

Assembler 

ESERV 



ASM 



(Note 2) 



2 
(IVP) 



^li 



20,480 
26,624 



19 
7 



120 
40 



IPKA 
IPKV 



38 605 
10 213 



BTAM 



BTM 
(Note 






Checkpoint/ 
Restart 

Direct Access (Disk) 
IOCS 



DAM** 
(Note 



52 
27* 



52 
34 



IJL 

+ 



65 177 






CKR I I 12* 20 

(Note 



64 7842 
1 26 



IJI 24 190 



-f 

3 10841 



— - — ~^ 

3 4 92 
1 381 



Diskette I/O Unit 
Disk ERP 



DIO 

DKE 
(Note 






1) 



20* 
6* 



20 
6 






Display Operator 
Console Support 



DOC 
(Note 



1) 



1 



31 



IJB 



1 21 



212 



Sequential Disk 
IOCS 



DSK** 
(Note 



22* 



22 



IJG 



39 213 



11 5363 



2) 



Emulators 
1401/1440/1460 
Emulator 
1410/7010 

Emulator 



EML 



(Note 2) 



21,000 
(Note 5) 

30,000 
(Note 5) 



8 
10* 



11 
16 

16 



IIR 



29 244 
25 237 



4 



31 5942 
(Note 6) 

30 3249 
(Note 6) 

^ 



Model 20 Emulator 



E20 
(Note 



2) 



25* 
7 



40 
7 



IIS 



72 495 



Environmental Re- 
cording, Editing, 
and Printing 
(EREP) 



ERP 
(Note 



10240 



2) 



1* 
76 



1 
204 



IJB 



76 863 



187 



Figure 1-17. D0S/7S System Program Sizes CPart 1 of 4) 
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Component 



Compiler IOCS 
Modules 



IBM 

Program 
Number 
5745-SC 



ANS*** COBOL 
ANS*** COBOL & COBOL 
ANS*** COBOL £ PL/I 
ANS*** COBOL, 

COBOL,, & PL/I 
COBOL 

COBOL gPL/I 
PL/I 

Required IOCS 
Modules 



Part 
Size 
Bytes 



lOM 
(Note 2) 



Phases 
20* 



Core Image Library 



Blocks 



-+ 



22 



-+ 



Note: This program 
consists of a 
group of various 
preassembled IOCS 
modules used by 
American National 
Standard COBOL, 
PL/I , and COBOL 
The digits given 
here represent 
the number of mod- 
ules used and the 
number of library 
blocks required by 
the various combi- 
nations of compi- 
lers desired. 



Relocatable 
Library 



I Source State 

-jment Library 

Prefix Blocks \- 

Modules I Books Blocks 

226 1388 I 



138 


991 


163 


1181 


169 


1100 


189 


1272 


77 


578 


107 


698 


70 


U12 



27 100 I 



4- 



—- i 



IOCS (See Note 2) 

Card (Readar/Punch) 

Console 

Device Independent 

(DTFDI) 

Printers 

Serial Devices 

PIOCS (DTFPH) 

Imperative Macros 



lOX** 



59* 



59 



IJC 64 154 I 

! 



IJJ 

IJD 



4 
23 



(Note 1) 



I 

18 1 
52 I 



2 
1 

2 
2 
1 
1 
27 



73 

206 

196 

51 

55 

306 



IPL and Buffer 
Load 



IPL 
(Note 1) 



9* 

6 



9 
24 



IJB 



22 165 I 



1- 

36 621 I 
I 



Index Sequential 
Disk IOCS 



ISM** 
(Note 2) 



21* 



28 



UH 



4 



1242 



Job Control 



JCL 
(Note 1) 



14,336 



3* 
11 



4 
64 



IJB 11 289 1 

I 

+- 



Librarian 

CORGZ 

MAI NT 

CSERV 

DSERV (sorted) 

RSERV 

SSERV 

PSERV 



LBR 



(Note 1) 



10,240 



9 
11 
1 
8 
1 
1 
1 



42 
41 

6 
16 

7 



IJB 
IJB 
IJB 
IJB 
IJB 
IJB 
IJB 



10 
19 
1 
2 
2 
2 
1 



152 I 
291 I 
24 I 
57 I 
29 I 
37 I 
23 1 

+- 

2 100 I 



Linkage Editor 



LNK 
(Note 1) 



10,240 



20 



IJB 



Magnetic Character 
Reader IOCS 



MCR** 
(Note 2) 



4* 



278 



Figure 1-17. DOS/VS System Program Sizes (Part 2 of 4) 
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Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 



Component 



IBM 

Program 
Number 
5745-SC 



Part 
Size 
Bytes 



Core Image Library 



Phases 



Blocks 



Relocatable 
Library 



Prefix Blocks 
Modules 



Source State 
ment Library 



Books Blocks 



Optical Character 
Reader IOCS 
1287 
3886 



OCR** 



(Note 2) 



2* 
2* 



712 
357 



OLTEP 

Configuration 
Data Sets 
Online Tests 
(OLTs) 



OLT 
(Note 2) 



2* 
47 



2 

81 

(Note 3) 
(Note 4) 



IJZ 50 400 



Probleim Deter- 
mination A i d s 
PDAID 

DUMPGEN 

LSERV 

SDAID 



PDA 



(Note 1) 



6,144 

10,240 
8,192 



15 

6* 

1 

1 

4 

2* 



27 
8 

23 
8 

25 
4 



IJB 

I JB 

IJB 
IJB 



41 

89 
19 
64 



Paper Tape IOCS 



PTP** 
(Note 2) 



3* 



593 
3117 
2013 



POWER 



PWR 
(Note 2) 



89 

1* 



96 
1 



FGP 89 545 



10 



QTAM 



QTAM 
(Note 2) 



22* 



34 



IJL 109 393 



78 



Recovery Management 

Support 

MCAR/CCH/RMSR 



RMS 



(Note 1) 



22 



15 



S up ervisor Macros 

Communi c a ti on 
Macros 



SUP 
(Note 1) 



3* 



21 



26 180 



Generatxon Macros 



Basxc 

MICR 

TP 



23 


3,687 


1 


237 


7 


181 



Magnetic Tape IOCS 



TAP** 
(Note 2) 



18* 



32 



IJF 18 77 



973 



Tape ERP 



TPE 
(Note 1) 



1 
10* 



4 
10 



IJB 



16 



VSAM 
AMS 



VSM 
(Note 2) 



13* 
23 
65 



14 
206 
232 



IDC 
IGG 
IIP 
IKQ 



12* 43 
189 2009 



14 



1399 



Figure 1-17. DOS/VS System Program Sizes (Part 3 of 4) 
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r T T T-' — 


~~"" — — 


m III in T-^«MM» 


-T- 


"•""^ ■" ""' ^^ 


■"^ ' '■ ■ 




•T 










1 


Relocatable 






IBM 1 iCore 


Image 


Library | 


Library 




1 Source State 




"Orr^rfK^m iPaT**!" L..—..^.^ 






L_ 








•^Irent Library 




IT X. U^X. ci 111 1 ircix. U !-—••-*— 






~T 


*^^ "' '" ~ "* 


-M'^^«W« 




1 Component 


Number jsize j Phas 
5745-SC JBytes j 


es 


Block 


s| Prefix Blocks 
j Modules 


1 


1 Books Blocks 


L«, 


^^__^_^^^^ J _^^__^^^^ 1 _^^^^ 






-4.- 








.J 


|,— , 


'^*"~ '""'""*" '"' [^■••"^""■■^"•^~"'"~"" 






t 








1 — 


iSystein Utility 


UTL 1 10,240j 
(Note 2) 1 1 


39 


171 




IJW 


56 


837 




1 Programs 






















1 Track Disk 




5 


41 




IJW 


6 


90 




j Assign Alternate 


















1 Track Data Cell 




5 


26 




IJW 


6 


69 




1 Clear Disk 




3 


7 




IJW 


^ 


34 




1 Clear Data Cell 




3 


7 




IJW 


n 


32 




jcopy Disk to Card 




2 


11 




IJW 


3 


51 




|Copy Disk to Disk 




2 


13 




IJW 


3 


57 




jcopy Disk or Data 


















1 Cell to Tape 




2 


11 




IJW 


3 


52 




jcopy and Restore 


















j Diskette 




1 


19 






1 


71 




i Deblock Utility 




1 


16 




IJW 


2 


63 




1 Initialize Disk 




4 


25 




IJW 


5 


108 




j Initialize Data Cell 




4 


18 




IJW 


5 


65 




1 Initialize Tape 




1 


5 




IJW 


2 


22 




j Restore Card to Disk 




1 


7 




IJW 


2 


32 




1 Restore Tape to 


















j Disk or Data Cell 




1 


8 




IJW 


2 


34 




jVTOC Display 




1 


5 




IJW 


4 


32 




j Transients 




1 


1 












i Distribution 


(Note 1) 1 1 
















i Program Supervisor 


















1 (8K> 


















JFast Copy Disk 


















1 Volume 




2 


49 






4 


56 


1 1 212 


jpage Data Set Dump 




1 


11 




IJB 


1 


40 




i (PDSDM) 



















L , X J. X i i J 



Notes; 

1. See subsequent sections for detailed information on this component. 

2. See the relevant separate book ircdule for a detailed information on this component. 

3. This is the formula to calculate the number of cere image library blocks necessary 
for the configuration data sets: 



number of d evi ces on system + 
6 



1 = 



number cf blocks 



4. The number of core image library blocks required for the On Line Tests (OLTs) depends 
on the number of device types on the system and the number and size of the tests 
needed for these devices. This information is in the description that accompanies 
the tests. 



♦ Transients 

*♦ See "Compiler IOCS Modules" 

♦** American National Standard 



for the preassembled module names and usage. 



5. This is the minimum partition size for the smallest program being emulated. For more 
information about storage requirements, refer to the emulator publication. 

6. 21 macros are common to the 1401/1440/1460 and the 1410/7010 emulators. These macros 
account for 1324 blocks. Hence the requirements for both emulators in a single 
system are 38 books and 6 44 blocks rather than the suit of the amounts shewn for each 
emulator. 

Figure 1-17. DOS/VS System Program Sizes (Part 4 of 4) 
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IOCS 

jSOURCE STATEMENT LIBRARY 

The following macros are shipped in the source stateirent library. 

N ote ; Module 7: "Compiler IOCS Modules", contains a list of preasseirbled modules 
required by system programs . 

File Definition Macros 



E . CDMOD 
E.DIMOD 
E.DTFBG 
E.DTFCD 
E.DTFCN 

E.DTFDI 
E.DTFEN. 
E.DTFPH 
E . DTFPT 
E.DTFSR 
E . PRMOD 



Imperative Macros 



E • CCB 
E. CHECK 
E. CLOSE 
E. CLOSER 
E.CNTRL 



Basic 

16-24 

8 
10 

14+10 if any Reg. is specified 
10-18 



For literals (1) For Variables 



+ 4 
+ 8 
+ 8 
+ 4 



Note 2. 
Note 3. 
Note 4. 



E . ERET 
E.EXCP 
E.FEOV 
E . FEOVD 
E.FREE 

E.GET 
E . LBRET 
E.NOTE 
E.OPEN 
E.OPENR 

E.POINTR 
E. POINTS 
E.POINTW 
E.PRTOV 
E.PUT 



2-6 
8-12 

8-12 



8 

2 
12 
10 
14+10 if any Reg. is specified 



8 

8-12 

8 

8 

8-12 



+ 0-4 
+ 4 

+ 0-4 

+4 per sym. naire 

+4 
+ 8 
+ 8 

+ 4 per sym. naire 
+ 4 

+4 per sym. naire 
+4 per sym, name 
+ 4 



Note 2. 
+ 2 

Note 3. 

Note 4. 

Note 2. 

Note 2. 

Note 2. 

Note 2. 
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E.READ 8-36 Note 5. +4 per sym. name Note 6. 

E. RELEASE 

E.RELSE 8 +U per sym. name 

E.SEOV 10 +8 +3 

E.TRUNC 8-12 +0-4 

E.WAITF 8-12 +0-4 Note 3. 

E. WRITE 8-26 Note 5. +0-4 

Notes ; 

1. Include the storage requirement for literals only once if the 
literal is used by more than one macro instruction. 

2. +4 per symbolic naire, +2 per ordinary register notation,, or +0 per 
special register notation. 

3. +4 per filename or +8 per register. 

4. +14 per filename or +8 per register. 

5. 20 bytes are required for BTAM. 

6. +38 No operands coded in register notation. 



The storage required by the imperative macros may be determined by using 
the preceding figures with Figures 1-18 through 1-22. 

Note: Read-only modules are recoirirended for virtual programs 
(RDONLY=YES). 



Module 1: Planning and Procedures 149 



CDMOD (CARD MODULE) 







r" 




TYPEFLE 




-1 






h 










1 




INPUT 1 


OUTFUT 1 


CMBND 


1 






1 


_4 




|._ 




1 


1 RECFORM 


1 I0AREA2I WCRKA 

1 1 

1 1 

1 1 

1 1 

1 1 

i 1 
1 1 


1 


1442 1 2560*1 1442 | 
2520 1 5425 | 2596 | 
2540 1 1 1 
2501 1 1 1 
2596 1 1 1 
3505 1 1 1 
3525 1 1 1 
3881 1 1 1 


2520 1 


254012560* or 5425] 
35251 T ^ 

1 For 1 For | 
1 Punch 1 Punch | 
|File 1 Inter-] 
1 Ipret 1 
i IFile 1 
1 1 1 


1442 1 2520 
1 2540 


1 


1 FIXUNB 


-4 4_ 

1 - 1 - 

-4 „„_4_>_.„. 

1 - 1 YES 


-+- 
-1- 


104 1 154 1 74 1 

jL J. J. 


4. 

80 1 
J. 


,.. 4 4 4. 

40| 104 1 96 j 

X -L 1 


4 

126 1 198 


"I 


1 FIXUNB 


106 1 160 1 116 1 


122 1 


84| 134 1 122 1 


154 1 226 




1 FIXUNB 
1 FIXUNB 


-4 4 

1 YES j 

_4 4 

I YES 1 YES 


-+- 
-4- 


136 1 176 1 118 1 
138 1 186 1 132 1 


4- 

124 1 
4_ 

138 1 


4 4 4. 

82| 140 1 - 1 

96| 150 1 - 1 


4 

126 1 198 

4 

154 1 226 


-i 


1 UNDEF 


-4 4 

1 - 1 - 


-+- 


- 1 - 1 112 1 


4- 

110 1 


4 4 4_ 

731 125 1 - 1 


4 


-^ 




_4. ^_ 4, 


1 


. .1 X «J._ 


_^ i_ 


L x_ — x_ 


i_ _ 




1 UNDEF 
1 UNDEF 
1 UNDEF 
j VARUNB 


t — ■""• — T 

1 - 1 YES 

-4 4 ,.. 

I YES 1 

1 YES 1 YES 

-4 4 

j - j - 


"t 

-+- 
-4- 


r : — T ""T" 

- 1 - 1 124 1 
.-.— _4 4 4- 

- 1 - 1 128 1 

4 4 4- 

- 1 - 1 140 1 

4 .^4 4. 

- 1 - 1 126 j 


132 1 

130 1 
4. 

146 1 
4- 

132 j 


^ 1. — 1._ 

92| 142 1 - 1 

90| 148 1 - 1 

104| 154 1 - 1 

94j 142 1 - 1 


— j._ 

4~ 

4 

4 


-\ 


|— — — — <r— • 

1 VARUNB 
1 VARUNB 
1 VARUNB 


1 - 1 YES 

1 YES 1 

1 YES 1 YES 


-4- 
-+- 
-+- 


- 1 -1 140 1 
4 4 4. 

- 1 - 1 154 1 

- 1 - 1 156 1 


4- 

146 1 
4, 

160 1 
162 1 


108| 164 1 - 1 

118j 166 1 - 1 
4. 4 4- 

120| 176 1 - 1 


4 

4— — 

~ — 4 


-\ 


t 


_X _« _X- 


I 


. «. X— X x_ 


X- 


X -X X- 


_«_x«, ^. 


1 




al space required 
ciated files: 


r- 












for asso 


FUNC= 1 TYPFLE 


— 1 
1 










L «. 


J 










1 INPUT 1 OUTPUT 1 
_ X X • 








4 4 

RP 1 48 1 56 
4 4 

RW 1 56 1 


— •! 
























4 4 

PW 1 - 1 48 

RPW 1 92 1 64 


— ^ 
























X X 


1 









Figure 1-18. CONTROL — CDMCD Storage Requireirents (Part 1 of 3) 

No tes; 

1. CTLCHR=YES or ASA; depending upon record fcrniat, nuirher of I/O 
areas, and/or work area specifications: 

For YES, a miniinuro of 8 to a inaximun) of 36 additional bytes are 
required. 
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For ASA, a minimum of 28 to a iraxiwuir of 65 additional bytes are 
required. 

RDONLY=YES changes the size of the modules -50 to +50 bytes. In 
addition, the user's prograiT; irust provide a 72-byte save area each 
time the module is reentered. 



Parts 2 and 3 of Figure 1-19 shows the requirements for the other 
CDMOD options. The values selected must be added to the TYPEFLE 
value to determine the amount of storage needed. 



r T T 1 

I CRDERR=RETRY | 2520 | 2540 | 

(. + + ^ 

I without I0AREA2 or WORKA j +73 | +123 | 

Y 4 + ^ 

I with either or both | +6 9 1 +119 | 
L . X X J 

Figure 1-18. CONTROL — CDMOD Storage Requirements (Part 2 of 3) 



T T 

lt»42 



T T 1 

2560* 13505/3525** 



j CONTROL=YES 
I 

I INPUT 



I I I I |or 5425 | | 



+26 



2540 j 2520 
I 

+82 I +30 



+ 44 I 



+ 94 



^ 

+36 I +26 

+20 I +38 



I OUTPUT without WORKA 
y 



+ 24 



I OUTPUT with WORKA 

j CMBND without WORKA 
^ 



+ 24 
+24 



+ 






+20 I +12 
+32 I +12 
+20 I +12 



I CMBND with WORKA 

L 



+ 32 



+ 32 I 



+12 



- I 

X- 



Figure 1-18. CONTROL — CDMOD Storage Requirements (Part 3 of 3) 

I*CONTROL may not be specified for input files associated with punch 
files on the 2560 or 5425. 
♦*CONTROL may not be specified for input files used as associated files 
on the 3525, 

DTFCD (DEFINE THE FILE CARD ) 

TYPEFLE=INPUT requires 50 bytes. (72 bytes for single file for a 25 60 
I or 5425, 56 bytes if ERROPT is specified for a 3505 or 3525, 82 bytes 
I plus the length of the card buffer if ASOCFLE is specified for a 2 560 cr 
I 5425, 60 bytes if ASOCFLE is specified for a 3525.) 

TYPEFLE=CMBND requires 84 bytes. 

TYPEFLE=OUTPUT requires 48 bytes (64 bytes for single file for a 2560 cr 

15425, 69 bytes plus the length of the card buffer if ASOCFLE is 
specified for a 2560 or 5425, 52 bytes if ASOCFLE is specified for a 
3525, 152 bytes if FUNC=I is specified for a 2560 or 5425, 128 bytes if 
FUNC=I is specified for a 3525) . 

CRDERR=RETRY (2540 only) requires an additional 88 bytes. 

DEVICE=2520 requires 8 additional bytes. 
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DIMOD (DEVICE INDEPENDENT SYSTEM UNITS MODULES) 

r T T 1 

I I Basic I I 

I TYPEFLE= I Module | I0AREA2=YES | 
^ + + ^ 

I I INPUT I 454 I +112 I 
|. + + ^ 

I I OUTPUT I 903 I +152 j 

■ L X i ^ J 

Note; RDONLY=YES changes the size of the ircdule -70 to +70 bytes. In 
addition, the user's prograir must provide a 72-b^te save area 
each time the module is reentered. 

Figure 1-19. DIMOD Storage Requirements 



DTFDI (DEFINE THE FILE DEVICE INDEPENDENT SYSTEM UNITS) 
The table requirement is 240 bytes. 

PRMOD (PRINTER MODULE) 

r TT T T T T T T ^^ 1 

I II I I I |CTLCHR= I I I 

I II BASIC I I I f T H I I 

|RECFORM=|| MODULE | WORKA=YES | I0AREA2=YES | PRINTOV |ASA | YES j CONTROL=YES |ERROPT=YES| 
I I I (Note 3) I I ! (Note 4) j ! [ (Note 5) | (Note 2) | 
j. ^^===c=^^„„^^^^ |._«, ^ 1 i i-. i-. i J 

IFIXUNB i f 72 I +6 I +24 | +34 |+128| | +40 | +68 | 
^ ++ 4 + 4 4 4 4 4_, ^ 

JUNDEF II 102 I +22 j +12 | +34 |+132|+4 | +40 | +68 j 
IVARUNB II 136 I +14 | +12 | +34 |+124|-4 | +40 | +68 | 

L XJ. X L X L L X r X J 

Note 1; RDONLY=YES changes the size of the module -50 to +50 bytes. In 
addition, the user's program must provide a 72-byte save area 
each time the module is reentered. 

Note 2; If ERROPT=YES is specified, then DEVICE=3211 must also be 

specified. For a 3525 add 22 bytes, instead of 68, for ERROPT. 

I Note 3; For the 2560 and 5425, the sizes are 166 bytes for FIXUNB, 190 
bytes for UNDEF, 206 bytes for VARUNB. For the 3525, add froir 
52 to 72 bytes to the size of the basic module, depending on 
the type of associated file specified. 

Note 4; For the 3525 add from 34 to 5 8 bytes. 

Note 5; For the 3525 add from 40 to 160 bytes. 

Figure 1-2 0. CONTROL — PRMOD Storage Requirements 

DTFPR (DEFINE THE FILE PRINTER) 

The table requirement is 48 bytes or 52 bytes if ERROPT is specified for 
the 3211 printer or, if ASOCFLE is specified, fcr the 3525 card punch. 
For the 2560 the requirement is 72 bytes for a single file or 64 bytes 

(for an associated file; for the 5425 the requirement is 56 bytes fcr 
either a single or an associated file. 
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DTFPH (DEFINE THE PHYSICAL IOCS) 



|[ 



r TT 1 

I Device | | size \ 
j. --^ 4+ ^ 

I Tape II lOU 1 
^ ++ ^ 

JDASD MOUNTED=ALL || 40 j 

DASD MOUNTED=SINGLE | | 8U | 
++ ^ 

3540 MOUNTED=SINGLE | | 84 | 
L X± J 



Note; No module is required for this macro instruction. 
Figure 1-21. CONTROL — DTFPH Storage Requirements 
DTFCN (DEFINE THE FILE CONSOLE) 



r T 

RECFORM=| WORKA= 



TYPEFLE= 



T T 

INPUT/OUTPUT I OUTPUT only | CMBND 



h + 

FIXUNB I 
^ + 

FIXUNB I YES 

+ — 



-4- 



■I 

60 I IHH 

90 I 252 
+ 



94 
150 






UNDEF 



156 



114 



UNDEF 



I YES 

.i i. 



262 



168 



Note: No module is required for this macro instruction. 

Figure 1-22. CONTROL — DTFCN Storage Requirements 

DTFSR (DEFINE THE FILE SERIAL DEVICE) 

When a DTFSR is assembled, it generates both a table and a module. For 
example, if DTFSR is used for a printer, a table and a ircdule are 
generated just as though DTFPR and PRMOD were used. To determine the 
storage requirements for DTFSR, add the table and the module 
requirements for the appropriate device type, such as 48 bytes (DTFPR) 
and n bytes (PRMOD) for a printer. 



IPL & Buffer Load 



Phases 



IPL 



CORE IMAGE LIBRARY 



Transients 



$$A$IPLA 
$$A$IPL1 
$$A$IPL2 



$IPLRT2 
$IPLRT3 
$IPLRT4 
$IPLRT5 



RELOCATABLE LIBRARY 



Module 



IJBIPL 
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Link-Edit Statements 



INCLUDE IJBIPL 
// EXEC LNKEDT 



Buffer Load (3203 Printer) 



CORE IMAGE LIBRARY 



where xxx is a two or three character 
identifier of the train type on ycur 3203 
printer other than the AN supplied in the 
core iirage library. 

PHASE SYSBUFLD,+0 
INCLUDE IJBSBUFF 
PHASE IJBSBUFFl,+0 
INCLUDE IJBSBUFl 
// EXEC LNKEDT 



T ransie nts (Required for I PL) 



Buffer Load(3211 Printer) 



$$BFCB3 

$$BUCB3 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 



CORE IMAGE LIBRARY 



Transients (Required for IPL if 3211 is 
present) 



Phases 



SYSEUFLD 
SYSBUFFl 



$$BFCB 

$$EUCB 

$$BUFLDR 

I $$EUFLD1 

" $$BUFLD2 



RELOCATABLE LIBRARY 
Modules 



Modules 



IJBSBUFF 

IJBSBUFl 

IJBTRAN 

IJBTRGN 

IJBTRPAN 

IJBTRPHN 

IJBTRPN 

IJBTRQNC 

IJBTRQN 

IJBTRRN 



IJBSBUFF 
IJBSBUFl 
IJBTRAll 
IJBTRGll 
IJBTRHll 
IJBTRPll 
IJBTRTll 



Link-Edit Statements 



IJBTRSN 
IJBTRTN 
IJBTRYN 
IJBTRALA 



LinkrEdit Statements 



PHASE $$BUCB3,+0 
INCLUDE IJBTRxxx 
// EXEC LNKEDT 



PHASE $$BUCB,+0 
INCLUDE IJBTRxnn 
// EXEC LNKEDT 

where xnn is the train on your 3211 printer 
ether than the All supplied in the core 
image library (transient $$BUCB) . 

PHASE SYSBUFLD,+0 
INCLUDE IJBSBUFF 
PHASE SYSBUFFl, +0 
INCLUDE IJBSBUFl 
// EXEC LNKEDT 
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Buffer Load (5203 Printer) 



Job Control 



CORE IMAGE LIBRARY 



Transien ts (Required for IPL) 



$$BFCB5 

$$BUCB5 (See Note) 

$$BOFLDR 

$$BUFLD1 

$$BUFLD2 



Note; This transient is not required for 
IPL when the UCS feature is not present. 



Phases 



SYSBUFLD 
SYSBUFFl 



RELOCATABLE LIBRARY 



Transients 



$$EJCOPT 
$$BJC0P1 
$$BLSTIO 



CORE IMAGE LIBRARY 



Phases 



$JOBACCT ♦ 

$JOBCTLA 

$JOBCTLB 

$JOBCTLD 

$JOBCTLE 

$JOBCTLF 

$JOBCTLG 

$JOBCTLJ 
$JOBCTLK 
$JOBCTLM 
$JOBCTLN * 

♦ Required for Job Accounting Interface 



Modules 



RELOCATABLE LIBRARY 



IJBSBUFF 

IJBSBUFl 

IJBTRHN 

IJBTRLC 

IJBTRGN 

IJBTRPN 



Link-Edit Statements 



PHASE $$BUCB5,+0 
INCLUDE IJBTRxx 
// EX^C LNKEDT 

WHERE XX IS THE TRAIN TYPE ON YOUR 5203U 
printer other than the LC suppled in the 
core image library. 

PHASE SYSBUFLD, +0 
INCLUDE IJBSBUFP 
PHASE SYSBUFFl, ♦0 
INCLUDE IJBSBUFl 
// EXEC LNKEDT 



Modules 



$JOBACCT 

IJEJC 

IJBJCB 

IJBJCl 

IJBJC2 

IJBJC3 

IJBJCt 

IJBJC5 

IJBJC6 

IJBJC7 

IJBJC8 (Job Accounting Interface) 

IJBJC9 



Link-Edit Statements 



INCLUDE IJBJC 
// EXEC LNKEDT 

INCLUDE $JOBACCT 
// EXEC LNKEDT 
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Linkage Editor 

CORE IMAGE LIBRARY 
Phases 



$LNKEDT Initialize/overhead (Phase 1) 
$LNKEDTA Pass 2 processor (Phase 7) 
$LNKEDTC Catalog processor (Phase 8) 
$LNKEDTO 12-2-9 processor, ESD only 
(Phase 2) 

$LNKEDT2 12-2-9 processor, non-ESD 

(Phase 3) 
$LNKEDTU Control card prccessor (Phase 

4) 
$LNKEDT6 Control card processor (Phase 

5) 
$LNKEDT8 MAP processor (Phase 6) 



RELOCATABLE LIBRARY 
Modules 



IJELBI 
IJELEl 



Link-Edit Statements 



INCLUDE IJBLE 
// EXEC LNKEDT 



not link-edit time. When making optimum 
wcrkfile assignments, the major 
consideration should be ccirpiler time. A 
savings in link-editing time is generally 
at the expense of compiler performance. 

When built by a language processor, 
SYSLNK contains 39 card images per track on 
a 2314/2319, 60 on a 3330, and 3a en a 
3340. When an object deck is used as input 
to the linkage editor, jcb ccntrcl forrrats 
SYSLNK. In this case, SYSLNK contains 16 
records per track on a 2314/2319, 28 on a 
3330, and 17 on a 3340; ESD, TXT, and RLD 
cards are packed 4 per record while all 
other input cards are not packed (1 per 
record) • 

In a ccirpile and link-edit situation, 
any allocation made for SYSOOl for the 
compilation is more than sufficient as a 
workfile allocation for the linkage editor. 
However, when you irust allocate SYSOOl, you 
can use the following inforrriationc The 
linkage editor workfile (SYSOOl) contains 
21 records per track on a 2314/2319, 35 on 
a 3330, and 20 on a 3340. The tctal number 
of records (R) required for link-editing a 
program is equal to the following: 



R = 1 
where 

Xi,X2# . . 



'MiHy--[¥\ 



= rounded high 

,Xn = number of RLD cards in each 
module to be processed by 
the linkage editor. 



WORKFILE REQUIREMENTS FOR LINKAGE EDITOR 



This section contains information for 
determining the workfile requirements for 
the linkage editor and assembler when the 
workfile is on an IBM 2314/2319, 3330, or 
3340. 

Two workfiles are used by the linkage 
editor: SYSLNK for input, and SYSOOl for a 
workfile. 

The best overall perforirance for 
link-editing results from using two disks 
and one tape: SYSRES and SYSLNK each 
assigned to a separate disk drive, and 
SYSOOl assigned to tape. When possible, 
SYSLNK should be assigned to the faster of 
the two disks because more I/O is performed 
on SYSLNK than on SYSRES. Because 
link-edit time is relatively small compared 
to assembler or compiler times, optimum; 
assignments for assembling and link-editing 
(or compiling and link-editing) should be 
based on assembler or compiler conditions. 



Librarian 



The following are the librarian programs. 

Note: Module IJBLBC (error iressage 

routine) is a common module used by 
more than one librarian program and 
also by the linkage editor. 



CORGZ 



CORE IMAGE LIBRARY 



Phases 



CORGZ 
CORGZl 
CORGZ 2 
CORGZ 3 
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C0RGZ4 
C0RGZ5 
C0RGZ6 
C0RGZ7 
C0RGZ8 



RELOCATABLE LIBRARY 
Modules 



IJBLBJ 
IJBLBK 
IJBLBS 
IJELBT 
IJBLBU 
IJBLBV 
IJBLBW 
IJBLBX 
IJBLBY 
IJBSL5 



Link-Edit Statements 



INCLUDE IJBSL5 
// EXEC LNKEDT 



MAINT 



CORE IMAGE LIBRARY 
Phases 



MAINT 

MAINTA 

MAINTCL 

MAINTCN 

MAINTDR 

MAINTEJP 

MAINTP2 

MAINTR2 

MAINTS2 

MAINTUP 

$MAINEOJ 



IJBLBG 
IJELEH 
IJBLBL 
IJELEM 
IJELEN 
IJELEQ 

IJELBZ 
IJEMCS 
IJEMDS 
IJEMDU 
IJBMIN 

IJBMIO 
IJBMUP 
IJBSL2 



Link-Edit Statements 



INCLUDE IJBSL2 
// EXEC LNKEDT 



CSERV 

CORE IMAGE LIBRARY 

Phase 

CSERV 

RELOCATABLE LIBRAR Y 
Module 

IJELEP 

Link-Edit Statements 



INCLUDE IJELBP 
// EXEC LNKEDT 



Update program routine 



RELOCATABLE LIBRARY 
Modules 



IJBLBA 
IJELEC 
IJBLBD 
IJBLBE 
IJBLBF 



DSERV 



CORE IMAGE LIBRARY 
Phases 



DSERV 
DSERVl 
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DSERV2 
DSERV3 
DSERV4 
DSERV5 
DSERV6 
DSERV7 



RELOCATABLE LIBRARY 
Modules 



IJBLBC 
IJESLl 



Link-Edit Statements 



INCLUDE IJBSLl 
// EXEC LNKEDT 



RELOCATABLE LIBRARY 



Modules 



IJELBC 
IJBSL3 



Link-Edit Statements 



INCLUDE IJBSL3 
// EXEC LNKEDT 



SSERV 



PS£R V 



CORE IMAGE LIBRARY 
Phase 



CORE IMAGE LIBRARY 
Phase 

SSERV 



PSERV 

RELOCATABLE LIBRARY 
Module 

IJBSL6 

Link-Edit Statements 



INCLUDE IJBSL6 
// EXEC LNKEDT 



RSERV 

CORE IMAGE LIBRARY 
Phase 



RELOCATABLE LIBRARY 
Modules 



IJELBC 
IJBSL4 



Link-Edit Statements 



INCLUDE IJBSL4 
// EXEC LNKEDT 



Supervisor 

CORE IMAGE LIBRARY 
Phase 



RSERV 



$$A$SUP1 
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SOURCE STATEMENT LIBRARY 



Notes: 



Supervisor Co mniunication Macros 



^ 





Real 


Storaqe Bytes 




Basic 


For Literals (Note 1 


E.ASYSCOM 






E. ATTACH 


18-32 


+0-4 (Note 2) 


E.CALL 


2-16 


+0-4 (Note 2) 


E. CANCEL 


4-6 


ALL+2 


E.CDLOAD 


8-10 


+ 0-8 


E.CHKPT 


38-42 




E.CHNG 






E.COMRG 


6 




E.DEQ 


4-8 


+ 0-4 


E.DEQB 






E. DETACH 


2-6 


+ 0-5 


E.DUMP 


6 


8 


E.ENQ 


4-8 


+ 0-4 


E.ENQB 






E.EOJ 


2 




E.EXIT 


2 




E.FCEPGOUT 




E. FETCH 


2-10 


+ 8-12 


E.FREEVIS 


2-10 




E.GETIME 


10-94 


+ 0-8 


E.GETVIS 


4-16 




E.JDUMP 






E.LOAD 


2-10 


+8-12 


E.MAPCCB 






E.MAPCOMR 






E.MAPPIB 






E.MAPRFTAB 




E . MVCOM 


12-16 


+0-4 


E.PAGEIN 






E.PDUMP 


10-28 


+ 0-16 


E.PFIX 






E.PFREE 






E.POST 


4-8 


+0-8 


E.RCB 


8-10 




E.REALAD 






E.RELPAG 






E. RETURN 


2-6 




E . RUNMODE 






E . SAVE 


4 




E.SETIME 


6-14 


+ 0-8 


E.SETPFA 






E.STXIT 


2-14 


+ 4-12 


E.SYSCOM 






E.TECB 


4 




E.VIRTAD 






E.WAIT 


10-14 


+ 0-4 


E.WAITM 


8-12 


+ 0-4 



1. Include the storage requirement for 
literals only once if the literal is 
used ty more than one macro 
instruction. 

2. +4 bytes per operand for variables. 



Supervisor Generation Macro s 



♦Basic: 

E. ALLOC 

E.ALLOCR 

E.ASSGN 

E.BDYBOX 

E.CONFG 

E.DPD 

E.DVCGEN 

E.FOPT 

E.IOINTER 

E.IOTAB 

E.MAPERPIB 

E.MCRAS 

E.MAPLOWC 

E.MAPPUB2 

E.PIOCS 

E.SEND 

E.SGAM 

E.SGCCWT 

E.SGDFCH 

E.SGDSK 

E.SGPMGR 

E.SGSVC 

E.SGTHAP 

E.SMICR 

E.STDJC 

E.SUPVR 
E.SYSIO 
E.VSTAB 

♦ For a detailed description cf storage 
requirements, refer to Supervisor Storaqe 
Requirements . 



E.IJLQDSCT 
E.IJLQTSVC 

Note; These macros are part of the QTAM 

program but are required to generate 
a QTAM supervisor. 
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System Generation Macros 



Z.DOSCHLV 
Z . DELETECL 
Z . DELETERL 
Z . DELETESL 
Z.LINKEDIT 



MCAR/CCH 

CORE IMAGE LIBRARY 
Transients 



$$AEERA1 
$$AEERA2 
$$ABERA3 
$$AEERA4 
$$ABERA5 



$$ABERA6 
$$ABERA7 



$$ABERRJ 
$$ABERRP 
$$ABERRQ 

$$ECCHHR 
$$RASTOO 
$$RAST01 

$$RAST02 
$$RAST03 
$$RAST04 
$$RAST05 
$$RAST06 

$$RAST08 

$$RAST09 
$$RAST10 
$$RAST11 
$$RAST13 



CCH and Initial MCAR analysis 

Channel and irachine check record 

builder and recorder 

Channel check analysis 

EFL and MCAR analysis 

Unit record channel check ERP 

Unit record channel check ERP 

3505 and 3525 channel check 

handler ERP 

Machine check and channel check 

record writer 

Partition reallccaticn 

ERP message writer 

Message writer 



160 DOS/VS System Generation 



Transients 



Device Error Routines and OPEN/CLOSE Phases for DOS/VS 



The following is a list of required system control and commo n IOCS 
transients. Type A transient routines (device error routines) have the 
prefix $$A. ($ is an alphabetic character in Systeni/37 0.) Type B 
transient routines (OPEN/ CLOSE, CHKPT, etc.) have the prefix $$B. 



$$A$SUP1 
$$ABERAA 
$$ABERAB 
$$AEERAC 
$$ABERAD 
$$AEERAE 
$$ABERAF 
$$AEERAG 
$$ABERAH 
$$AEERAI 
$$AEERAN 
$$AEERA1 
$$AEERA2 
$$AEERA3 
$$AEERA4 
$$AEERA5 
$$AEERA6 
$$AEERA7 
$$AEERP1 
$$AEERP2 
$$AEERP3 
$$ABERP4 
$$ABERP5 
$$ABERP6 
$$AEERP7 
$$ABERP8 
$$AEERP9 
$$AEERRA 
$$ABERRB 
$$AEERRC 
$$AEERRD 
$$AEERRE 
$$ABERRF 
$$ABERRG 
$$ABERRH 
$$ABERRI 
$$AEERRJ 
$$AEERRK 
$$ABERRL 
$$AEERRM 
$$AEERRN 
$$AEERRO 
$$AEERRP 
$$AEERRQ 
$$AEERRS 
$$AEERRT 
$$AEERRU 
$$AEERRV 
$$ABERRW 
$$AEERRY 
$$ABERRZ 
$$AEERR1 
$$ABERR2 
$$AEERR3 



Supervisor 

Statistical counter update (tape) 

Tape ERP 

Tape ERP 

Tape ERP 

Tape ERP 

Tape ERP 

Tape ERP 

Tape ERP 

Tape ERP 

3886 OCR ERP 

RMSR 

RMSR 

RMSR 

RMSR 

RMSR 

RMSR 

RMSR 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

BTAM ERP 

Error recovery ircnitcr 

Disk ERP 

Setup 2560 restart inforiraticn 

2560/5U25 ERP repositioning 

Setup 5425 restart inforiraticn 

3211 ERP 

3504/3505 Card reader and 3525 card punch ERP 

2245 ERP 

2495 tape cartridge reader ERP 

Statistical counter update (non-tape) 

RMSR message writer 

ERP message writer 

ERP iressage writer 

ERP message writer 

ERP message writer 

3211 RMSR 

3211 RMSR 

MICR ERP 

1287/1288 OCR ERP 

1017/1018 Paper tape ERP 

2671 Paper tape ERP 

1052 Console printer keyboard ERP 

Unit record ERP 

Physical attention routine 

2311 Data cell ERP 

2321 Data cell ERP 

2321 Data cell ERP 
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$$AEERRU 
I $$AEERR5 
I $$AEERR7 
$$AEERZ1 
$$BATTNA 
$$EATTNB 
$$BATTNC 
I $$EATTND 
$$BATTNE 
$$EATTNF 
$$BATTNG 
$$EATTNH 
$$BAT1'NQ 
$$EATTNR 
$$BATTNS 
$$EATTNT 
$$BATTNU 
$$EATTNV 
$$BATTNW 
$$BATTNX 
$$BATTNY 
$$EATTNZ 
$$BATTN2 
$$EATTN3 
$$BATTn5 

$$BCCPT1 
$$BCE0V1 
$$ECHKPD 

$$BCHKPE 
$$ECHKPF 
$$ECHKPT 
$$BCHKP2 
I $$BCHK3G 
I $$BCISOA 



2321 Data cell ERP 

2321 Data cell ERP 

3540 Diskette ERP 

Physical attention routine 

Supervisor, program teririnatcr 

Supervisor, program terminator 

Supervisor, initiator 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Process ALTER statement 

Process DSPLY statement 

DUMP comirand processor 

DUMP command processor 

DUMP comirand print routine 

Supervisor, nonresident attention routine 

Supervisor, nonresident attention routine 

Display and change dispatching priority 

SDAID termination routine 

Storage dump of part of storage specified by two 

addresses 

System required tape open 

Monitor-EOV/EOF 

Disk-checkpoint 

Disk-checkpoint 

Disk-checkpoint 

Tape-checkpoint 

Tape-checkpoint 

Erase gap for logical files 

ISAM - CLOSE 



$$ECLOSE 
$$BCLOSP 
$$BCL0S2 
$$BCMT01 

$$BCMT02 
$$ECMT03 
$$BCMT04 
$$ECMT05 
$$BCMT06 



Close monitor 

Punch file close 

Close 

Tape EOF/EOV input-forward 

Tape CLOSE-alternate switching 
Tape CLOSE input-backward 
Tape EOV output-forward 
Tape CLOSE 
Tape CLOSE-workf iles 



$$BCMT07 
$$BDMPBC 

$$BDMPVA 
$$EDRSTR 
$$BDUMP 

$$EDUMPB 

$$BDUMPD 

$$BDMPDC 



$|BENDFF 
$$BENDFL 
$$BEOJ 



Tape-alternate switching 

Supervisor, program termination and system dump on 

tape/printer (part 2) 

Supervisor, program terminator, and SVA dump 

Disk restart phase 

Supervisor, program terminator, and system dump 

monitor 

Supervisor, program terminator, and system dump en 

tape/printer (part 1) 

Supervisor, program terminator, and system dump on 

disk (part 1) 

Supervisor, program terminator, and system dump en 

disk (part 2) 

ISAM -ENDFL (Load phase 2) 
ISAM -ENDFL (Load phase 1) 
Supervisor, program terminator 



162 DOS/VS System Generation 



$$EE0J1 
$$BE0J2 



Supervisor, program terminator 
Supervisor, program terminator 



$$BE0J2A 

$$BE0J3 

$$EE0J3A 

$$BEOJU 

$$BE0J5 

$$BE0J7 

$$BERRTN 
$$BFCB 

I$$BFCB3 
$$BFCB5 
$$BILSVC 
I $$BINDEX 
$$BJCOPT 
$$BJC0P1 
$$BJDUMP 
I $$BLVTOC 

$$BLSTIO 
$$BMSGWR 
$$BMVKEY 
$$B0CPM1 
$$B0CPM2 
$$B0CPT1 
$$E0CPT2 
$$B0CPT3 
$$B0CPT4 
$$BOCP01 
$$EOCP02 
$$BOCP03 
$$B0CP11 

$$B0CP12 

$$BOCRTA 
$$BOCRTB 
$$EOCRTC 
$$BOCRTD 
$$BOCRTE 

$$BOCRTF 
$$BOCRTG 
$$EOCRTH 
$$BOCRTK 
$$BOCRTL 

$$BOCRTM 
$$BOCRTN 
$$EOCRTO 
$$BOCRTP 
$$BOCRTQ 
$$EOCRTR 

$$EOCRTS 
$$EOCRTT 
$$EOCRTU 
$$EOCRTV 
$$EOCRTW 
$$BOCRTX 
$$BOCRTY 
$$EOCRTZ 



Supervisor, 
Supervisor, 
Supervisor, 
Supervisor, 
Supervisor, 
Supervisor, 



program 
program 
program 
program 
program 
program 



terminator 
terminator 
terminator 
terminator 
terminator 
terminator 



System required error recovery 
3211 FCB standard load 
3203 FCB standard load 
5203 FCB standard load 
Supervisor, program te 
Cylinder index in cor 
Job Control, OPEN T^e 



Job Control, OPEl^ape routine 

JDUMP indicator 

List VTOC (2311, 2314/19, 3330, 




inator 
(ISAM) 
routine 



and 3340) 



System control 

Tape open/close 

Printlog utility status modifier 

System required message writer 

System required message writer 

System required OPEN for input tape (Phase 1) 

System required OPEN for unlabeled output tape 

System required OPEN for labeled output tape 

System required OPEN for input tape (Phase 2) 

System required table, disk DTFs, OPEN Version II 

System required table, ncndisk DTFs, OPEN Version II 

System required table, unit record, OPEN Version II 

System required table, tape or disk system DTFs, OPEN 

Version I 

System required table, tape system DTFs 

CRT task initialization, activation, and deactivation 

Hard-copy disk ERP 

Message analysis & message transfer tc screen buffer 

Multi-line message transfer to screen buffer 

CRT ERP, part 1 

CRT ERP, part 2 

Redefine message status; output from buffer to screen 

Message writer screen to hard-copy file 

CRT task activator and operator input check routine 

Message deletion by means of K command 

Message deletion by means of cursor 
K-command handler status definition 
Screen line-number handler 
Restore function for release 
Screen update 
Initialize read 

Read/command 

Move data 

Updating of wrap-around pointer in hard-copy file 

Cursor positioning in case of error 

Message writer 

Conversation handler 

Multi-line message handler 

CRT root phase 
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$$B0CRT1 
$$B0CRT2 
$$B0CRT3 
$$B0CRT4 
$$B0CRT5 
$$B0CRT6 



$$BODACL 
$$BODAIN 
$$B0DAI1 
$$B0DA01 
$$E0DA02 

$$E0DA03 
$$BODAOU 
$$B0DAU1 



Redisplay - supervisor interface 

Redisplay - coirirand analysis 

Redisplay - read messages froro hard-copy file 

Redisplay - write to screen 

Redisplay - save/restore screen image 

Redisplay - ccmirand checking 

Note; The DOC-support transients ($$EOCRTn) are 
automatically generated if MCDEL=115 or i25 is 
specified in the CONFG macro. If DOC support is not 
desired, a DELET statement is required for each 
transient. If DOC support is required but one or more 
of the DOC-support transients have been deleted, the 
system enters a hard wait state. 

Close Routine-DA 

Direct access input-OPEN (Input) 

Open input-DA 

Direct access-OPEN output Phase 1 

Direct access-OPEN output Phase 2 

Direct access OPEN-output Phase 3 
Direct access OPEN-output Phase 4 
Direct access-OPEN 



$$B0DI01 
$$B0DI02 
$$B0DI03 
$$B0DI04 
$$B0DI05 
$$B0DI06 
$$B0DI07 
$$BQDIQ8 

$$BODMSG 
$$B0DMS2 
$$B0DQUE 

I $$E0DSM0 
$$BODSMW 

I $$BODSPO 
$$BODSPV 

$$BODSPW 

I $$BODUCP 

$$BOFLPT 

I$$BOIS01 
$$BOIS02 
$$BOIS03 



Diskette OPEN-input Phase 1 
Diskette OPEN-output Phase 3 
Diskette OPEN-output Phase U 
Diskette CLOSE-input/output 
Diskette OPEN-input Phase 3 
Diskette OPEN-input Phase 4 
Diskette OPEN-output Phase 5 
Diskette OPEN-output Phase 6 

Diskette Message Writer Phase 1 

Diskette Message Writer Phase 2 

Dequeue JIB's 

Diskette security message writer 

Message writer 

Diskette VTOC Display Phase 2 

Disk VTOC display routine 

Disk VTOC display routine 
Diskette DTFCP/DTFDI OPEN 
DASD file protect 
ISAM - OPEN I/O Phase 1 
ISAM - OPEN I/O Phase 2 
ISAM - OPEN I/O Phase 3 



$$BOIS04 
$$BOIS05 
$$BOIS06 
$$BOIS07 
$$BOIS08 

$$BOIS09 
$$BOIS10 
$$BOMRCE 
$$B0MSG1 
$$BCMSG2 

$$B0MSG3 
$$B0MSG4 
$$B0MSG5 



ISAM - OPEN I/O Phase 4 
ISAM - OPEN I/O Phase 5 
ISAM - OPEN I/O Phase 6 
ISAM - OPEN I/O Phase 7 
ISAM - OPEN I/O Phase 8 

Indexed sequential independent overflow area integrity 

ISFMS - OPEN 

OPEN for CMR and RCE 

Message non-abort types 

Message writer - abort types 

Message writer 
Message writer 
Message writer 
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$$B0MSG6 
$$B0MSG7 



Message writer 
Message writer (ASCII) 



$$BOMT0M 
$$BOMT0W 
$$BOMT01 
$$BOMT02 
$$BOMT03 

$$BOMT04 
$$BOMT05 
$$BOMT06 
$$BOMT07 
$$EONVOL 
$$BOPEN 

$$BOPENC 
$$BOPEND 
$$BOPENR 
$$B0PEN1 
$$E0PEN2 
$$BOPIGN 
$$BOPNLB 



$$B0PNR2 
$$B0PNR3 
$$B0RTV1 
$$B0RTV2 
$$B0SDC1 

$$B0SDC2 
$$BOSDEV 
$$B0SDI1 
$$B0SDI2 
$$B0SDI3 
$$B0SDI4 

$$B0SD01 
$$B0SD02 
$$B0SD03 
$$B0SD0 4 
$$B0SD05 

$$B0SD06 
$$B0SD07 
$$B0SD08 
$$B0SD09 
$$B0SDW1 

$$B0SDW2 
$$B0SDW3 
$$BOSD00 
$$BOSD01 
$$BOSIGN 

$$EOUR01 

$$BOVDMP 

$$BOWDMP 

$$B02321 

$$BPCHK 

$$BPDAID 

$$BPDUMP 



Tape OPEN iressage 

Tape OPEN message 

Tape OPEN input-forward- standard labels (Phase 1) 

Tape OPEN input-fcackward-standard labels 

Tape OPEN output forward-standard label 

Tape OPEN output-standard labels 

Tape OPEN l/,0-forward/backward nonstandard/unlabeled 

Tape OPEN workfiles 

Tape OPEN input-forward-standard labels (Phase 2) 

Tape rewriting 

RMSR tape processor 

OPENC 

Disk OPEN voluire ID handler 

Relocation Phase 1 

Open itionitcr 

Open monitor 

Open monitor 

Locates system source statement library (for 

assembler, COBOL, MAINT, and SSERV) or procedure 

library (for PSERV) 

Relocation Phase 2 

Relocation Phase 3 

ISAM Open 

ISAM Open 

Sequential disk I/O - CLOSE 

Sequential disk-close 
DTFDA and DTFSD Forced End of Volume 
Sequential disk input - OPEN 
Sequential disk input - OPEN 
Sequential disk input - OPEN 
Sequential disk input - OPEN 

Sequential disk output Phase 1 - OPEN 
Sequential disk output Phase 2 - OPEN 
Sequential Disk output Phase 3 - OPEN 
Sequential disk output Phase 4 - OPEN 
Sequential disk output Phase 5 - OPEN 

Sequential disk open - Phase 6 
Sequential disk output - OPEN 
Sequential disk output - OPEN 
Sequential disk output - OPEN 
Sequential disk workfiles Phase 1 - OPEN 

Sequential disk workfiles Phase 2 - OPEN 
Sequential workfile Phase 3 - OPEN 
Sequential disk OPEN - output Phase 
Sequential disk OPEN - output Phase 1 
System open 

Unit record-OPEN routine 

Disk VTOC dump 

Disk VTOC dump 

OPEN data cell 

Supervisor - program terminator 

Problem Determination 

PDUMP on SYSLST (part 1) 
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$$BPDMPC 
$$EPSW 

$$BRELSE 
$$BRMSG1 
$$BRMSG2 
$$BRSTRB 
$$BRSTRT 

$$BRSTR2 
$$BRSTR3 
$$BRSTRa 
$$BSDRUP 
$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFL 

$,$BSETL 

$$BSETL1 

$$BSYSWR 

$$BTERM 

$$BUCB 

$$BUCB3 

$$BUCB5 

$$BUFLDR 

$$BUFLD1 

$$BUFLD2 

$$B3540I 

$$B3540O 

$$B35400 



PDUMP on SYSLST (part 2) 
Supervisor - program terminator 

Device release 

Message writer CHKPT-RSTRT 

CHECKPOINT-RESTART message writer 

Tape Restart 

RESTART message writer - Phase 2 

Tape and DASD verify for restart 

DASD verify for restart 

Tape Reposition 

Suppress writing on recorder file 

ISAM load Phase 2 of SETFL 

ISAM load Phase 3 of SETFL 

ISAM load Phase 4 of SETFL 

ISAM load Phase 1 of SETFL 

ISMOD - SETL 

ISMOD - SETL 

Supervisor, nonresident attention 

Supervisor, program terminator 

3203, 3211, and 5203 UCSB standard load 

3203 UCSB standard load 

5203 UCSB standard lead 

3203, 3211, and 5203 FCB and UCSB IPL loader 

3203, 3211, and 5203 FCB IPL leader 

3211 FCB and UCSB IPL loader error routine 

Diskette OPEN-input Phase 1 

Diskette OPEN-output Phase 1 

Diskette OPEN-Phase 



Attention Routines, Initiators, 
Terminators, and Dumps 

Standard System Dunip 

CORE IMAGE LIBRARY 
Transients 



IJBJBMP ♦ 
IJBPDPMO ♦ 
IJBPDPST 

♦Modules common to Standard System Dump and 
Translating System Dump. 



Link-Edit Statements 



$$BDMPBC 

$$BDMPVA 

$$BDMPDC 

$$BDUMP 

$$BDUMPB 

$$BDUMPD 

$$BJDUMP 

$$BPDMPC 

$$BPDUMP 



RELOCATABLE LIBRARY 

IJEDMB * 
IJBDMBST 
IJBDMD * 
IJBDMDST 
IJBDMPMO * 
IJBDMPVA ♦ 
IJBDUMPS 



INCLUDE IJBDUMPS 
// EXEC LNKEDT 



Translating System Dump 



CORE IMAGE LIBRARY 



Transients 



$$BDMPBC 

$$EDMPDC 

$$BDUMP 

$$BDMPVA 

$$BDUMPB 

$$BDUMPD 

$$BJDUMP 
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$$BPDMPC 
$$BPDUMP 



RELOCATABLE LIBRARY 

IJBDMB * 
IJBDMBTR 
IJBDMD ♦ 
IJBDMDTR 
IJBDMPMO * 
IJBDMPVA * 
IJBDOMPT 
IJBJDMP * 
IJBPDPMO * 
IJBPDPTR 



♦ Modules coitiinon to Standard Systeir Dump and 
Translating System Dump. 



Link-Edit Statements 



INCLUDE IJBDUMPT 
// EXEC LNKEDT 



Attention Routines, Initiators, 
Texminatoxs 

CORE IMAGE LIBRARY 
Transients 



$$ABERRZ 
$$ABERZ1 
$$BATTNA 
$$BATTNB 
$$BATTNC 
$$BATTND 
$$BATTNE 
$$BATTNF 
$$BATTNG 
$$BATTNH 

$$BATTNQ 

$$BATTNR 

$$BATTNS 

$$BATTNY 

$$BATTNZ 

$$BATTN2 

$$BATTN3 

$$BEOJ 

$$BE0JS1 

$$BE0JS2 

$$BE0J1 

$$BE0J2 

$$BE0J2A 

$$BE0J3 

$$BE0J3A 



§$BECJU 

$$BE0J5 

$$BECJ7 

$$BILSVC 

$$BPCHK 

$$EPSW 

$$BSYSWR 

$$ETERM 



Checpoint/Restart 



CORE IMAGE LIBRARY 



Transients 



$$ECHKPD 
$$ECHKPE 
$$ECHKPF 
$$BCHKPT 
$$BCHKP2 
$$ECHK3G 
$$BRMSG1 
$$ERMSG2 
$$BRSTRT 
$$BRSTR2 
$$BRSTR3 
$$BRSTR4 



SOURCE STATEMENT LIBRARY 
Macro 

CHKPT 



Disk Erxox Recovery Pxoceduxes (DKE) 



CORE IMAGE LIBRARY 
Transients 



$$ABERRB 
$$ABERR1 
$$ABERR2 
$$ABERR3 
$$ABERRU 
$$ABERR5 



SOURCE STATEMENT LIBRARY 
M acro 

SGDSK 
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Display Operator Console Support 



Phase 



CORE IMAGE LIBRARY 
Transients 



$$BMVKEy 
$$BOCRTA 
$$BOCRTB 
$$EOCRTC 
$$BOCRTD 

$$BOCRTE 
$$BOCRTF 
$$BOCRTG 
$$BOCRTH 
$$BOCRTK 

$$BOCRTL 
$$EOCRTM 
$$BOCRTN 
$$EOCRTO 
$$BOCRTP 

$$EOCRTQ 
$$BOCRTR 
$$EOCRTS 
$$BOCRTT 
$$BOCRTU 

$$EOCRTV 
$$BOCRTW 
$$BOCRTX 
$$BOCRTY 
$$EOCRTZ 

$$B0CRT1 
$$BCCRT2 
$$E0CRT3 
$$B0CRT4 
$$B0CRT5 
$$E0CRT6 



SOURCE STATEMENT LIBRARY 
Macros 



CRTAEX 

CRTAWT 

CRTGEN 

CRTIO 

CRTSAV 

PUTR 



PRINTLOG 

RELOCATABLE LIBRARY 
Module 

IJEPRT 

Link-Edit Statements 



INCLUDE IJEPRT 
// EXEC LNKEDT 



Tape Error Recovery Procedures (TPE) 



CORE IMAGE LIBRARY 
Transients 



$$ABERAB 
$$ABERAC 
$$ABERAD 
$$ABERAE 
$$AEERAF 

$$ABERAG 
$$AEERAH 
§$ABERAI 
$$RAST07 
$$RAST12 



Phase 

ESTVUT 

RELOCATABLE LIBRARY 
Module 

IJETESUT 



PRINTLOG (Print the Hard-Copy File) 



CORE IMAGE LIBRARY 



Link-Edit Statements 



PHASE ESTVUT, -s-O 
INCLUDE IJBTESUT 
// EXEC LNKEDT 
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Problem Determination Aids 



PDAID 



RELOCATABLE LIBRARY 
Kcdule 

IJBDMPGN 



CORE IMAGE LIBRARY 
Phases 



PDAID 

PDAIDFTT* 

PDAIDFTP* 

PDAIDFTW* 

PDAIDGTT* 

PDAIDGTP* 

PDAIDGTW* 

PDAIDITT* 
PDAIDITP* 
PDAIDITW* 
PDAIDQTT* 
PDAIDQTW* 
PDAIDTDP* 
PDAIDTDT* 
PDLIST 



♦Only present in core-image library. 



Transients 



$$BATTNT 
$$BATTNU 
$$EATTNV 
$$BATTNW 
$$BATTNX 
$$EPDAID 



RELOCATABLE LIBRARY 
Modules 



IJBPDAID 
IJBPDLST 



Link-Edit statements 



PHASE DUMPGEN,+0 
INCLUDE IJBDMPGN 

/♦ 

// EXEC LNKEDT 



SDAID 



CORE IMAGE LIBRARY 
Phases 



SDAIE 
SDAID2 
SDPAR 
ENDSD 



Transients 



$,$ESDAID 
$$EATTN5 



RELOCATABLE LIBRARY 



Modules 



IJESDADl 
IJBSDAD2 
IJESDEND 
IJESDPAR 



DUMPGEN 



Link-Edit Statements 



CORE IMAGE LIBRARY 
Phase 

DUMPGEN 



// JOB 

// OPTION CATAL 

INCLUDE IJBSDLNK 
/* 

// EXEC LNKEDT 
/& 
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LSERV 



Link-Edit Statements 



CORE IMAGE LIBRARY 
Phase 

LSERV 

RELOCATABLE LIBRARY 
Module 



PHASE LSERV, +0 
INCLUDE IJBLSERV 

/♦ 

// EXEC LKKEDT 



IJBLSERV 



170 DOS/VS System Generation 



Page of GC33-5377, revised November 30, 1973, by TNL GN33-8766 



Supervisor Nucleus -5745-SC-SUP 



I Number of 
I Phases 



Number of Library 
Blocks 



32 



CONFIGURATION 

Figure 1-2 4 represents the parameters and 
their specifications of the IBM-supplied 
supervisor. 



P ^. 

I Operation] 
I" 



Operand 



SUPVR 

CONFG 

STDJC 

FOPT 

PIOCS 

VSTAB 

lOTAB 

SEND 

END 



NPARTS=1 , CHAN= YES , RMS=NO 
MODEL=125 

OLTEP=NO,SYSFIL=YES 
BMPX=YES,TAPE=7,DISK=(3 330, 3340) 
RSIZE=96K,VSIZE=128K,SVA=(64K,0K) 
JIB=1U, 0342 0=2, 02314= 2, D333 0=2,0334 0=2 
X'8000' 



Figure 1-24, SUPERVISOR 

(32K) — IBM-Supplied 
Supervisor for DOS/VS 



CORE IMAGE LIBRARY 
Phase 

$$A$SUP1 
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Modular Outline 



Machine Requirements 177 

POWER with RJE 178 

Central System 178 

Terminals Supported 178 

IBM 2780 Data Transmission 

Terminal (Model 1 or 2) 178 

IBM 2770 Data Communication System .179 

IBM 3780 Data Coirmunication 

Terminal 180 

Programming Requirements 181 

Storage Estimates for a Mininum POWER 

Partition 181 

LUBs for the POWER Partition 181 

POWER Support for the IBM 2560, 

3525, and 5425 182 

IBM 2560 and 5425 . 182 

IBM 3525 182 

POWER Program Generation Parameters , .183 
QFILE and DATAFIL File Management . .183 
Routine and Job Entry Management . . .186 
Diagnostic Support Parameter DIAG . .192 

RJE Management 192 

Generating POWER without Remote Job 

Entry .193 

Generating a Small Writer-Only POWER 
System . .200 

Disk Storage Requirements, 

Functions, and Supervisor 

Prerequisites . 200 

Assembling and Link-Editing POWERl .200 
Generating a Small Reader/Writer 
POWER System 203 

Disk Storage Requirements, 

Functions, and Supervisor 

Prerequisites 203 

Real Storage Estimates for P0WER2 . 203 

Assembling and Link-Editing F0WER2 .203 



Generating POWER with Remote Job Entry 

(RJE) 207 

RJE Components Generation 211 

ETMOD Generation 211 

RJE Block Generation 213 

RJE Elcck Name List Generation . . .215 
Modifying the RJE Block Name List 

and RJE Blocks 216 

Userid List Generation 216 

Modifying the Userid List 217 

Generating a Small Pcwer RJE System . 217 
Disk Storage Requirements, 
Functions, and Supervisor 

Prerequisites 217 

RJE Components and Their Generation 218 

RJE Block 220 

BTMOD 220 

RJE Block Name List 220 

Userid List 221 

Real Storage Estimates for P0WER3 .221 

Assembling and Link-Editing P0WER3 .221 

Local Testing of POWER/RJE ...... .225 

Restrictions 225 

Test Startup 225 

Test Operations 226 

Ending the Test 226 

Total Size of the POWER Partition . . .226 
Link-Editing POWER for a Supervisor 

without Relocating Loader 227 

Start POWER 227 

POWER Phases and Macros 228 

POWER Library Space Requirements . . . .231 
Deleting POWER Phases and Macros .... 231 

Source Statement Library 231 

Relocatable Library ........ 231 

Core Image Library 232 
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Modular Index 



ACCOUNT 183, 186 
ADDITR 183, 186 
assembling and link-editing 

POWER 200, 203, 221 
AUTOSTR 183, 186 



IBM 3780 Data Communication Terminal 180 
3780 Terminal Build-up 180 
required features 180 
features - supported 180 
features - not supported 180 
I/O units, attachable (IBM 2770) 179 
I/O units, not-supported (IBM 2770) 179 



BTMOD generation 211, 220 



JOBSEP 183, 187 



central system requirements 17! 



DATAFIL 183 

DBLK 183, 184 

deleting POWER phases and macros 231 

DIAG 183, 192 

diagnostic parameter (DIAG) 192 

DISK 183, 184 

disk storage requirements , functions and 

supervisor prerequisites 200, 203, 217 
D3540 183, 184 



generating POWER without Remote Job 

Entry 19 3 
generating POWER with Remote Job 

Entry 20 7 
generating the POWER RJE components 211 
generating a small reader/writer POWER 

system 203 
generating a small writer-only POWER 

system 200 
generating a small POWER RJE system 20 7, 
207, 217 



labels contained in assembly listing 
line mode settings for RJE terminals 
attached to a CPU Model 115 or 125 
LINETAB 183, 187 
local testing of POWER RJE 225 
LUBs for the POWER partition 181 
LUBs , required number of 19 3 



machine requirements 

partition priority 177 

POWER with RJE 17 8 
macros 

for local POWER 228 

for POWER RJE 228 
MAXBUFS 183, 191 
MAXCCB 183, 191 
MAXJOBS 183, 184 
MAXRJS 183, 192 
MAXRW 183, 191 
modifying the RJE Block Name List and 

RJE blocks 216 
modifying the Userid List 217 



226 



180 



IBM 2780 Data Transmission Terminal 
required features 178 
special features - supported 179 
special features - not supported 

IBM 2770 Data Coiranunication System 
I/O units that may be attached 
I/O units, not supported 179 
features - not supported 180 
features - supported 180 



179 



179 



NTRKGP 183, 185 
NUMDDKS 183, 185 



parameters and components affecting the 

size of POWER 184 
phasenames 

POWER 228 

POWER with RJE 228 
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POWER program assembly and link-editing 200 
POWER program generation parameters 

QFILE and DATAFILE management 183 

routine and job entry 186 

diagnostic 192 

RJE management 19 2 
POWER RJE 

program assembly and link-editing 
212, 221 

support for the IBM 2560,5425 and 
3525 182 

system generation steps 20 7 
POWPART 183,^ 191 
PRIORTY 183, 191 
programming requirements 181 
PUB entries, required number of 19 3 



QFILE and DATAFIL file management 
parameters 183 



SLI 183, 191 

space requirements 

core image library 231 
relocatable library 231 
source statement library 2 31 

starting POWER 227 

STDCARD 183, 19 2 

STDLINE 183, 192 

storage estimates for a minimum POWER 
partition 181 

SUBLIB 183, 192 



TAPE 183, 192 

terminal identification names 208 

terminals, supported 178 

total size of the POWER partition 226 

TRACKGP 183, 185 



QFILE records per track; number of 185 



Userid List, assembling and cataloging 

the 221 
Userid List generation 213, 221 
user identification names 20 8 



RDRCLOS 183, 191 

READER 183, 191 

real storage estimates for a small 

writer-only version of POWER 202 
real storage estimates for a small version 

of POWER with RJE 221 
Remote Job Entry (RJE) 178 
restrictions to testing POWER 225 
RETRY 183, 192 
RJBLKLST 20 8 

RJE Block generation 213, 220 
RJE Block Name List generation 215, 220 
RJE components generation 211, 218 
RJE components 

RJBTMOD 20 8 

RJBLKLST 20 8 

RJUSERS 208 
RJE management parameters 19 2 
RJE test 225 

startup 225 

operations 226 

ending 226 
RJEBLK 213 
RJEND 183, 192 
RJUSERS 20 8 
routine and job entry management 186 
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The description of POWER generation contained en the following pages is 
intended for use by system support staff responsible for installing and 
maintaining the program as part of a DOS/VS system. 

The section contains primarily reference material. You are, 
therefore, assumed to be familiar with the concepts and facilities of 
POWER as they are described in the following lEM DCS/VS manuals: 



IBM DO S/VS System Management Guid e, GC33-5371 

IBM Introduction to DOS/VS, GC 3 3- 53 70 

IBM DOS/VS Operating Procedures , GC 33-5378 

IBM DOS/VS System Control Statements, GC 33-5376 

IBM OS/VS and DOS/VS Assembler Language, GC 3 3- 4 010 

IBM Guide to the DOS/VS Assembler, GC 33-4024. 

An understanding of the general logic of POWER may be of some help in 
planning an installation-tailored POWER version that will increase jcb 
throughput. The general logic of POWER is described in the D OS / VS POWE R 
Logic manual, SY33-8565, in the section "Introduction" and "Method of 
Operation" and in the introductory paragraphs of the sections describing 
an execution processor or a print or punch writer routine (called a task 
in that manual) , 

The material in this module has been arranged in the following way: 

• The section "Machine Requirements" describes the central system and 
the intermediate storage requirements for a POWER system with and 
without RJE (Remote Job Entry), as well as the terminals supported by 
RJE. 

• The section "Programming Requirements" lists a number of special 
programming requirements for the generation of POWER. 

• The section entitled "POWER Program Generation Parameters" discusses 
the POWER program generation parameters and describes the available 
options . 

• The next two sections "Generating POWER without RemiCte Job Entry" and 
"Generating POWER with Remote Job Entry" give separate step-by-step 
accounts and examples of procedures for generating POWER without, and 
with, RJE support. The examples include disk and partition space 
requirements, supervisor prerequisites and assemblies of POWER 
systems. 



Generating the RJE components is described under 
Generation" . 



'RJE Components 



Machine Requirements 



•I 



POWER operates on any IBM Systemi/370 CPU with the minimum direct access 
storage devices required by DOS/VS. It resides in a real partition with 
a priority higher than that of the partitions it controls. POWER 
supports programs running in real and in virtual mode. 

Generally, one IBM 2311 or 2314 disk pack, 100 cylinders on an IBM 
3336 disk pack, or 200 cylinders on an IBM 33U8 data module are 
sufficient for the POWER data files. All POWER files must be on like 
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units, for example, all on 2314 disk drives or all on 3330 disk drives. 
For the 33U0, all extents of the DATAFIL must reside on the same type cf 
3348 data module. Multiple disk extents ard multiple disk volumes are 
supported to a maximum of 5 extents for the DATAFIL file. POWER data 
files should not reside on a voluire containing frequently used files. 



POWER with RJE 

To run POWER with Remote Job Entry (RJE) the following requirements must 
be met regarding central system and terminals. 



CENTRAL SYSTEM 

The central system must include: 

• An IBM 2701 Data Adapter Unit (DAU) with Synchronous Data Adapter, 
Type II, equipped with EBCDIC code and transparency, or 

• An IBM 2703 Transmission Control Unit CTCU) with Synchronous Base, 
Synchronous Terminal Control - EBCDIC and Synchronous Line Set, or 

• For a Model 135 CPU, an Integrated Communications Adapter (ICA) with 
a Synchronous Data Adapter, Type II, equipped with half "duplex 
facility, EBCDIC code, and transparency. 

• For a Model 115 or 125 CPU, an Integrated Communications Adapter 
(ICA) with one of the following: 

- Synchronous line group 

- Synchronous line low load 

- Synchronous line medium speed (with or without clock) . 



TERMINALS SUPPORTED 



The POWER/RJE program can support up to five remote terminals of the 
type IBM 2770, 2780, or 3780: 



IBM, 2780 Data Tr ansmission Termina l ( Model 1 or 2) 

This terminal can be connected to the central system by common carrier 
leased or switched facilities or privately owned comirunication 
facilities. The devices that are attachable to the IBM 2780 are 
described in Comp onent Description ; IB M 2780 Data Transiriss!ion 
Terminal, GA27-3005. 

Requ ired Features 

• Terminal use - point-to-point 

• EBCDIC transmission code 

• Extended retry transmission 

• Line termination 

• Print line (120 or 144 characters) 
9 EBCDIC transparency. 
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N o t e ; All punched output to a remote terminal is in transparent 
mode. If punched output is not a requirement, and if the user 
transmits in non-transparent mode only, the EBCDIC transparency 
feature on the 2770/2780 and transparency on the 2701 Data Adapter 
Unit., 2703 Transmission Control Unit, or Integrated Ccmmunicaticns 
Adapter may be omitted. 

Special Features - Supported 

• Automatic answering 

• Automatic turnaround (Model 2) 

• Multiple record transmission 

S pecial Featu r es - Not Supported 

• Multipoint line control 

• Printer horizontal format control 

• Selective character set 

• Terminal identification. 



IBM 2 770 Data Communi cati on System 

This system may also be used as an RJE terminal. It can be connected to 
the central system by means cf common carrier leased or switched 
facilities. The devices that are attachable to the IBM 2770 are 
described in S ystem Components: I BM 2770 Data Co mm un ication Sys tem ,, 
GA27-3013. 

I/O Units that may be Attached 

• 545 Output Punch, Model 3 or 4 (output switch 2) 

• 2203, Model Al or A2, or 2213 Printer, Model 1 or 2 (output switch 1) 

• 2502 Card Reader, Model Al or A2 (input switch 2). 

Note; A card reader and a printer are required, a card punch is 
optional, 

I/O Units - Not Supported 

50 Magnetic data inscriber 

1017 Paper tape reader 

1018 Paper tape punch 
1255 Magnetic character reader 
2265 Display station Model 2. 

Required Features 

• Terminal use - point-to-point 

• EBCDIC transmission code 

• Extended retry transmission 

• WACK response (wait before transmit - positive acknowledgement) 

• Line termination 

• EBCDIC transparency. 

N ot e; All punched output to a remote terminal is in transparent 
mode. If punched output is not a requirement, and if the user 
transmits in non-transparent mode only, the EBCDIC transparency 
feature on the 2770/2780 and transparency on the 27 01 Data Adapter cr 
Unit or Integrated Communications Adapter may be omitted. 
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Features -^ Supported 

• Automatic answering 

• Buffer expansion (256 or 512 bytes). 

Featur es - Not Supp orte d 

• Multiple data link control 

• Terminal identification. 

Note on line m ode s ettings for R JE ter irinals attached to a CPU Model 115 
or_125: The bit settings of the line irode specification for a 278 or 
2770 POWER RJE terminal that is attached to a Model 115 cr 125 CPU, are 
described in IBM SYSteni/370 Model 115 Functional Characteristics, 
GA33-1510, and in IBM Systeni/3 70 M odel 125 Funct ional Characteristic s, 
GA33-1506, respectively. 



IBM 37& Data Communicati on Terminal 

This terminal may also be used as an RJE terminal. It can be connected 
to the central system by means of common carrier leased cr switched 
facilities. The devices that are attachable to the IBM 3780 are 
described in Component In fprirati o n for the IBM 3 7 80 Data 'Communi cations 
Terminal, GA27-3063. 

Th e 3780 termina l consists of : 

• A card reader 

• A printer 

• A terminal console 

• (optionally) A 3781 card punch 

Required Features 

• EBCDIC transmission code 

• Extended retry transmission 

• WACK response (wait before transmit - positive acknowledgement) 

• EBCDIC transparency 

Note; All punched output to a remote terminal is in transparent 
mode. If punched output is not a requirement, and if the user 
transmits in non-transparent mode only, the EBCDIC transparency 
feature on the 3780 and transparency on the 2701 or 2703 or on the 
Integrated Communications Adapter may be omitted. 

Features - Supported 

• Additional print positions 

• Component select 

• Punch attachment 

Features - Not Supppr ted 

• Multiple data link control 

• Component ID feature 
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Programming Requirements 

For a DOS/VS system that is to include POWER, the following prograrrniing 
requirements must be met: 

• The DOS/VS supervisor must be generated with POWER=YES in the 
supervisor generation macro SUfVR. 

• The minimum real storage requirements for the PCWER partition must be 
met (see "Storage Estimates for a minimum POWER Partition" in this 
section) . 

• A sufficient number of logical unit blocks (LUBs) must be generated 
for the POWER partition (see "LUBs for the POWER Partition"). 

• The physical unit block (PUB) table must be large enough to 
accommodate entries for POWER dummy devices (see "Generating a 
Version of POWER and "Using POWER" in the DOS /VS System M anagemen t 
Guide, GC33-5371, for dum.my device assignment). 

• POWER supports the unit-record devices described in section 5 of the 
manual Introduction to DOS/VS, GC 33-537 0. If POWER is to support the 
IBM 2560, 3525, or 5425, the considerations and restrictions 
described under "POWER Suppcrt for the IBM 2560, the IBM 3525, and 
5425" must be observed. 



Storage Estimates for a Minimum POWER Partition 

The minimum sizes for the POWER partition with one partition supported 
are: 

POWER Version K Bytes 

Writer Only Version 2 

Reader /Writer Version 2 

RJE (with one RJE Routine) 42 

Depending on the POWER generation paramieters chosen,, however, additional 
re^il storage is required. 



LUBS FOR THE POWER PARTITION 

A sufficient number of LUB entries for programmer logical units SYSOOO 
to SYSnnn must be generated for the POWER partition. The default value 
of 5 is usually not enough. The number of LUB entries may be calculated 
as foll^ows: 

n = 2+d + u + v 

where 

n = number of LUB entries for the POWER partition 

d = number of DATAFIL disk drives (see NUMDDKS) 

u = number of POWER unit-record devices and/or tape units (see 

MAXCCB) 
v = number of RJE lines (see MAXRJS) 
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For each partition supported by POWER, LUBs rnust be generated just as 
for a multiprogramming systeir without POWER. 



I POWER SUPPORT FOR THE IBM 2560, 3525, AND 5425 
I IBM 2560 and 5t<25 



POWER supports the IBM 2560 and the IBM 5425 as a SYSRDR, SYSIPT, or 
SYstCH device. If SYSPCH is assigned to the 2 560 or the 5425, POWER 
supports; 

• program-controlled stacker selection 

• punch interpret 

• card print 

• punch/print 

The 2560 and 5425 are subject tc the fcllowing restrictions: 

• POWER cannot perforir any output functions on input cards (for 
instance, no read and punch into the sanie card) = 

• POWER ignores stacker selection for input cards. 

• Read colurrin binary is not supported. 

• Hopper 1 is always used for input, hopper 2 for output. Therefore, 
the assignment for the duirmy punch device has to be irade in the forir: 

ASSGN SYSPCH, X*CUU',H2 

• POWER does not support read and punch functions simultaneously. 

Note; Jobs with SYSIN assigned to a 5425 must contain an additional 
blank card before the /6 card, regardless cf the device type used to 
read in the job. 



IBM 3525 

POWER supports the basic read and punch functions cf the IBM 3525 card 

reader. Punch interpret and punch/print are also supported, as well as 

the card print feature. If SYSPCH is assigned tc the 3525, POWER 
supports the following functions: 

• print 

• punch/print (multi-line) 

• automatic line positioning 

• user-controlled line positioning 

• print overflow 

POWER does not support: 

• optical mark read (OMR) 

• read column eliminate (RCE) 

• column binary card reading 

• read and punch functions simultaneously. 
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POWER Program Generation Parameters 

This part describes the parameters that create the POWER program 
There are four categories of POWER macro parameters: 

1. QFILE and DATAFIL ir.anageirent: 

DBLK 

DISK 

D3540 

MAXJOBS 

NTRKGP 

NOMDDKS 

TRACKGP 

2. Routine and job entry management: 

ACCOUNT 

ADDITR 

AUTOSTR 

JOBSEP 

LINETAB 

MAXBUFS 

MAXCCB 

MAXRW 

POWPART 

PRIORTY 

RDRCLOS 

READER 

SLI 

STDCARD 

STDLINE 

SUBLIB 

TAPE 

3. Diagnostic param.eter 
DIAG 

4. RJE management parameters 

MAXRJS 

RETRY 

RJEND 



QFILE AND DATAFIL FILE MANAGEMENT 

If you intend to use more than cne version cf POWER (for example one 
with and one without RJE) , you should make the QFILE and DATAFIL 
parameters as well as the POWPART parameter identical across your 
versions to avoid difficulties with extent allocations. 



DBLK= 



10241 This parameter specifies the block size of DATAFIL 
n) records and, consequently, the size cf each data 
buffer (data buffers are used as I/C areas by the 
execution processors, reader/writer and RJE 
routines). n rrust be an integral multiple cf eight 
not smaller than 288; the maximum is 3624 on a 2311, 
or 4000 on all other disk devices. If the QFILE 
record size determined by POWER (see MAXJOBS) is 



Module 2: Generating a Version of POWER — 5745-SC-PWR 183 



greater than the value specified, DEIK is set to the 
QFILE record size. For small tlock sizes the 
following table shows the interdependencies of DELK 
and the QFILE record size, which depends on the 
number (P) of partitions supported, and number of 
track groups (NTRKGP) that can be handled: 



DBLK 


L 


Sufficient for 
p Partitions 


j._ 


Sufficient for 
NTRKGP up to 




y 




T 




288 




2 




352 


304 




3 




400 


376 




4 




600 


336 




4 




485 


452 




4 




800 


528* 




4 




1000 



j *MiniuiT; for 3211 printer support 



( 231 1) 

)2314( 
DISK= 13330 

(3334) Specifies the direct access device type for the 

ACCTFIL, QFILE, and DATAFIL files (specification of 
2314 includes 2319). The QFILE and DATAFIL must be 
on devices cf the same type, for example, all en 
2314 or all on 3340. For a 3340 all extents of the 
DATAFIL must be on the same module type. 

(NO 1 
D354 0= (INPUT) This parameter specifies, by means of the INPUT 

operand, that the 3540 diskette I/O unit is to be 

supported as POWER input device. 



MAXJOBS= 11 



'i] 



This parameter specifies the maximum number cf 
job entries POWER is able tc manage at one time, n 
may be any number from 1 tc 512. MAXJOBS determines 
the size of the QFILE, because MAXJOES + 1 is the 
number of records in the QFILE. The size of a QFILE 
record (in bytes) is equal to the larger of the 
following two records: 

a) 208 + 32 X p (size of QFILE master record) 

b) 151 + 3 X ((NTRKGP + 7)/8) (size of QFILE JCT) 

where: p= number cf partitions supported 

NTRKGP = number of track groups you want to handle 

To determine how many QFILE records fit on one 
track, you have to know the physical charateristics 
of the disk type that is tc contain the QFILE. 

The following table gives examples cf how many QFILE 
records miay fit on one track of the various types of 
disk devices. 
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j NTRKGP 



500 



1000 



^ +- 




-T- 




-+- 




"T- 




|No. of partitions! 


2 




4 




2 




4 


1 supported | 
















L ^_ «.J._ 




L_ 




— X— 




_J 




r """ — ""T 




— r 




~T 




t 




IQFILE record size| 


3t»8 




348 




536 




536 


|in bytes^ | 
















L 4._ 




— X— 




— X- 




— X— 




r — — r 




T 




1 — 




T** 




|No, of records | 
















Iper track^: | 
















1 2311 1 


11 




11 




6 




6 


1 2314 1 


15 




15 




11 




11 


1 3330 1 


27 




27 




19 




19 


1 33U0 1 


16 




16 




12 




12 



j ^rounded off, if necessary, to the next higher 
I multiple of 8. 



^For a description of track capacities, see the 
DOS/VS Data Management Guide, GC33-5372. 



NTRKGP= 



240 
2001 
1901 
n. 



This parameter specifies the maximum number of 
track groups to be handled by POWER, n may be any 
number up to 1000. The default for a 2311 or a 2314 
is 200; for a 3330 it is 190, and for a 3340 it is 
240. If,, for example, you specify 1S1TRKGP=1000 and 
TRACKGP=10 (see the TRACKGF parameter) for a 2311, 
then 10,000 tracks or five full volumes may be used 
for DATAFIL. A maximum of five extents is accepted 
for the DATAFIL. If you want to use less disk space 
than specified during system generation,, you can 
reduce the space to be handled by POWER with EXTENT 
cards. 



NUMDDKS= 



This parameter specifies the maxiffium number of 
disk volumes on which the DATAFIL may reside, n may 
be 1, 2, 3, 4, or 5. Nc matter what the NUMDDKS 
specification is, five extents will be handled, if 
present en the volume (s). It is, however, not 
necessary to use all disk volumes specified, nor is 
it necessary to have each disk extent on a different 
volume. 



TRACKGP=n Specifies the number of tracks in a track group. A 
track group is the amount cf disk space that POWER 
allocates for each job entry upon a request for 
space by any POWER routine. The following values 
may be substituted for n: 

Device Values 

IBM 2311 1, 2, 5, or 10 

IBM 2314/2319 1„ 2, 4, 5, 10, or 20 

IBM 3330 1,, 2, 3, 6, 9, or 19 

IBM 3340 1, 2, 3, 4, 6, or 12 

The default is 10 for a 2311, 20 for a 2314/2319, 
and 1 for a 3330 or 3340. 



For the 3330, the sizes of the individual track 
groups are as follows: 
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r 


-T 1 


1 TRACKGP= 


jSize of Each Track Group | 




|cn One Cylinder | 


L ^_ 


L J 


r 


T 1 


1 19 


|19 1 


1 9 


|9, 10 1 


1 6 


\6, 6, 7 1 


1 3 


|3, 3„ 3, 3, 3, 4 1 


1 2 


|2, 2, 2, 2, 2. 2, 2, 2, 3| 


1 1 


|1, .... 1 1 


L 


-JL J 



A job entry containing only twelve input records 
will use a full cylinder if DISK=2311 and 
TRACKGP=10. On the other hand, if five full 2311 
disk volumes are required for the DATAFIL, then 
NTRKGP=1000 and TRACKGP=10 have to be specified to 
enable POWER to manage that much disk space. 



ROUTINE AND JOB ENTRY MANAGEMENT 



ACCOUNT= NO 
(YES 



This parameter specifies that POWER is to maintain 
job accounting information. The information includes 
duration tiire, number of print records, number of punch 
records, etc. For each completed jcb entry one record cf 
information is stored in the ACCTFIL. 



ADDITR= 



10000 
n 



This parameter specifies the additional number 
of lines to be printed or cards to be punched before a 
second message is issued. The first message is issued after 
STDCARD or STDLINE threshold values have been exceeded. 
ADDITR applies to either punch or print output, whereas 
STDLINE and STDCARD apply to print and punch output 
respectively. For ADDITR, n may be from 1 to 5 numeric 
characters. 



AUTOSTR= JNO 

( tcuurdr] , [nrdr] , [cuuprt] , tnprt] , [cuupun] , [nnpun] ) 

Allows you to specify that partition-independent 
reader/writer routines are to be started automatically by 
POWER when it is initiated (therefore, the term "autostart 
option") . 

It specifies the default values for the devices, the number 
of buffers and the pause code to be used in case the 
abbreviated S (start) command is used for reader and writer 
routines. 

cuu specifies the I/O device for which the reader, print, 
and/or punch routine is to be started automatically. 

n for the reader and print routine or the first n for the 
punch routine specifies the number of buffers (1 or 2) to be 
used. The second n for the punch routine specifies the 
pause code (0, 1, or 2). Oiritted or zero indicates that the 
forms number specified in the * $$ PUN card is net to be 
displayed on SYSLOG. One (1) indicates that each forms 
number is to be displayed on SYSLOG and that the routine is 
to pause before processing each job entry. Two (2) 
indicates that every new forms number is to be displayed and- 
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that the routine is to pause before processing the job entry 
with the new foriris number. If the second character is 
omitted, zero is assuired. The first character must not be 
omitted, if a patise code is desired. 

The autostart options specified during systeir generation iray 
be overridden by the S (start) coir.rr.and. 

Examples of the AUTOSTR parameter: 

1. Autostart for reader routine (OOC) and print writer 
routine (OOE); one buffer for the reader routine, two 
buffers for the print writer routine, and one buffer and 
pause code one (1) for the punch writer routine: 

AUTOSTR=(OOC,1, 00E,2, ,11) 

2. Autostart for reader routine; no buffer option: 
AUTOSTR=(00C) 

3. No autostart; two buffers for each routine: 
AUTOSTR=(,2,,2,,2) 

U. Autostart for all routines; no buffer option: 

AUTOSTR=(00C„,0 0E,,00D) 

JOBSEP=(no ) Specifies that two separator pages are to precede 

(yes I the printed output of each job entry so that it is easier to 
split POWER job output. 

LINETAB={d0,dl,d2,d3,d4,d5,d6,d7,d8,d9,dl0,dll,dl2) 

Describes the forms control tape or the forms control 
buffer of the dummy printers. The operands of the 
LINETAB parameter correspond to the punches in the 
forms ccntrcl tape or to the channel positions in the 
forms control buffer which is used when the output is 
listed on the printer. with POWER the print output of 
your program; is no longer present tc handle the 
end-of-page ccrdition when POWER writes the output en 
the printer. LINETAE enables POWEP to calculate the 
next line on a page for all print operations, even in 
case of skip operations and to simulate channel 9 and 
channel 12 occurrences tc allow the program to format 
end-of-page output correctly. 

If LINETAB is specified, all values in the sublist must 
be specified. The values for dO to dl2 must be given 
in the form of two numeric characters. 

With POWER, one channel can have only one punch per 
page, and the channel 12 punch must always be the last 
one on the page. 

The values of the sublist are calculated as follows: 

• dl up to dl2 must be 00 for each channel without 

punch or, fcr a channel with punch, must be the 

number of the line that contains a channel punch 
minus one. 
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• do specifies the nurrber cf lines en the page that 
follows the line with the channel 12 punch up to the 
end cf the page. 

The total number of lines en a page is: 

dO + dl2 + 1 

Consider the following exairple which is illustrated in 
Figure 2-1: Assume you want to start printing on line 
5 with a heading, then skip to line 14 to continue 
printing up to the end of line 51. The corresponding 
LINETAB paraireter would have to lock as follows: 

LINETAE=(1 2,04,13, 00,00,00,00,00,00,00,00,00,5 3) 

If LINETAE is not specified, channel skips and the 
channel 12 occurrence are handled during program 
execution as if 

LINETAE= (10, 00, 05, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55) 

In this case, dl corresponds to the first line cf 
the page. 

If LINETAE is omitted, LINETAE values cannot be 
established or changed with the ** $$ PRT* statement. 



188 DOS/VS System Generation 



!BI=-, 






pmmm si 

;BM 407. 40a. 40r 



.,_L™^J^ 



' '■*'!" 



.,..^^.^_^.w 



J . , 



jj_,:.,i.„.ii,ilir 



.. ,;J::j>,5,5./;Sj 






^j.liX4.L:L.. 



6 , , I 



TEXT 



:.E^' 



■,.L„ 



"~'f" t ■"■■"3" ''\'-—i 






'■■t - ■ 



ri;:i 



j;::'::,iJi:;::: 



"V 



r---: ^-- i-'-r-'-i --■- • 



LAST LINE OF TEXT 



End of Patje 



I Fig 



ure 2-1. Forms Control Tape 



Module 2: Generating a Version of POWER — 57U5-SC-PWR 189 



MAXBUFS=i7 

In 



Specifies the iraxiiruin nurrber of data buffers that 
POWER icay allocate for the handling of data, 
n can be up to 99; it is determined on the basis of the 
nuirber of execution processors and of reader, writer, 
and RJE routines which iray be active at one tiire, as 
shown in Figure 2-2. 



Minimum 
Required 

Execution Processor in I 2 
a Writer-Only System 

Execution Processor in I 3 
a Reader/Writer System, 



For each partition 
Supported 



JData Buffers 



For each Print Writer, 
Punch Writer, and Reader 
Routine, depending on the 
Buffer Option specified 
in the S (start) Command 
or in the AUTOSTR 
Parameter^ 



RJE Routine 



Maximum 



.y 

(Program. 
-{Buffers 
(See MAXRW) 



7 for first 
RJE routine 
3 for end 
additional 



SS^O Reader Routine 



I 

JL. 



h 



One additional buffer is required for the handling 
of operator commands. 



^ 



I ^Two buffers can be specified. | 

L J 

♦Depends on the buffer size: sufficient to hold the 
contents of one 354 Diskette track. 



Figure 2-2. MAXBUFS Parameter 



MAXCCB= 



Assume a reader/writer system that services two 
partitions and supports one card reader, one punch, and 
one printer. The mdnimumi number of data buffers 
required would be 10; the m.aximum 17. If less than the 
maximum is specified or if not enough real storage is 
available for the maximum num.ber of buffers, the 
individual routines may compete for buffer space, 
reducing the performance of the system. 

The MAXCCB parameter specifies the maximum number of 
unit record and tape devices POWER may use at cne 
time, n may be any number from 1 to 26. If no tape 
spooling is done (TAPE=NO) , n should be a^ large as the 
MAXRW specification. One additional CCB is required 
for each tape device that POWER may use for output 
spooling, 

MAXRW=j3J 

!N| This parameter specifies how many IK-byte blocks of 
real storage are to be reserved for the reader and 



(i) 
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writer routines. One block is necessary for each 
reader or writer routine that is to te active 
simultaneously. Two blocks are necessary for each 
reader routine that reads frcir a 3540 diskette reader, 
n inay be any number up to 26. This parameter affects 
the values of MAXCCB and MAXBUFS. If the operator 
attempts to start a routine after the maximum is 
reached, the systeir will inforir him that no more 
routines may be started. 

POWPART=([BG] [,Ft»] [,F3] [,F2] [,Fl]) 

The POWPART parameter specifies the partitions that 
POWER is to support. The partition into which POWER 
will be loaded at execution time must not be specified 
as one of the operands within the sublist. The 
priority of the partition in which POWER resides must 
be higher than any of the priorities of the 
POWER-supported partitions. 

The partitions may be stated in any crder. The first 
in the list, however, is the default partition for 
partition-independent reader routines. If no JECL is 
used or if the ** $$ JOB' statement does not contain 
the partition parameter, the reader routine places the 
job entry into the input queue of this default 
partition. If only one partition is specified in the 
list, the parentheses may be omitted. 

If this parameter is omitted, the default taken is BG. 

Note; If multitasking is performed in a partition 
supported by POWER, only the I/O requests issued by the 
main task are handled by POWER. 

PRI0RTY=fN0) Specifies the default priority of a job entry when 

(n I PRIORTY is not specified in the '♦ $$ JOB' statem.ent* 
n maybe from to 9, whereby is the lowest and 9 is 
the highest priority. 

If NO is specified, POWER treats job entries on a first 
in - first out basis. 

RDRCLOS= (pause) This parameter specifies the action the reader 

\ EXIT) routine should take when end-of-file and end-of-job 

entry are encountered simultaneously, PAUSE causes the 
routine to wait for the operator to submit more input. 
EXIT causes the routine to terminate and release its 
buffers. 

READER= (yes) This parameter specifies whether reader 

no) support is required. When YES is specified, a 

reader/writer version will be generated. When NO is 
specified, reader capability is not available; the 
result is a writer-only POWER version, which requires 
JECL. 

SLI=(no I SLI=YES allows you to include informiation from a 

Iyes) private or system source statement library into a job 
entry. When source library inclusion is supported and 
a * $$ SII statement is encountered in the job stream, 
POWER searches the private source statement library (if 
it has been assigned) and the system source statement 
library for the requested book and inserts it into the 
job stream. This parameter is not valid in a 
writer-only version. 
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STDCARD= 1 720 I This parameter specifies the number cf punch 

( n] operations that are intercepted per job entry before a 
warning message is issued to the operator, n may be 
any number up to 99999. (See also ADDITR.) 

STDLINE= flOOOO) This parameter specifies the number cf print 

\ nj operations that are intercepted per job entry before a 

warning message is issued to the operator, n may be 
any number up to 99999. (See also ADDITR.) 

SUBLIB=(p) This parameter specifies the sub-library of the 
(X) source stateff:ent library to be searched when the 
sub-library is not specified in the *♦ $$ SLI' 
statement. 



TAPE= I NO Specifies that tape spooling of output for single 

(YES job entries is to be supported. If YES is specified, 
MAXCCB should be MAXRW plus the number of tape units 
that may be used concurrently for tape spooling. 



DIAGNOSTIC SUPPORT PARAMETER DIAG 



DIAG=f no) Specifies the inclusion of an internal feature that 
(yes) records POWER events for debugging purposes. 



RJE MANAGEMENT 



RJE requires certain system resources which must be accounted for during 
POWER/RJE generation. Each RJE routine requires two data buffers. 
Therefore, the MAXBUFS generation parameter must include these RJE 
requirements. 



MAXRJS= 



RETRY= 



1} 



This parameter specifies the maximum number of 
RJE routines which may be active concurrently. n may 
be from to 5. If MAXRJS is or is not specified, 
RJE is net generated. If the operator attempts to 
start an RJE routine after the maximum is reached, the 
system will reply that no more routines may be started. 
This operand does not affect the MAXRW specification. 

This parameter specifies the number cf retries 
(in intervals cf 2 8 seconds) that may occur before an 
intervention required condition must be corrected at 
the terminal. If no corrective action is taken before 
the RETRY count is exhausted, the RJE routine detaches 
the terminal. Interrupted output will be saved; 
interrupted job entry input will net be entered into 
the POWER reader queue. On a switched line,, the 
terminal will be disconnected. This feature permits 
other terminals to use the RJE facilities and prevents 
the RJE routine from being tied up. n may be any 
number from 3 to 2 0. 

RJEND- I Nol This parameter specifies the action the RJE 

Iexit) routine is to take when an RJEND statement is received 
from a terminal. EXIT specifies that the routine will 
terminate and free its buffers. NO specifies that the 
routine will wait for the next terminal call. With 
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terminals on lines that do not have the autoanswer 
feature, it may happen that a terminal does not 
disconnect properly. It is, therefore, recommended to 
specify RJEND=EXIT to permit the routine to terminate. 
In the meantime, the terminal operator can manually 
disconnect the terminal line. 



Generating POWER without Remote Job Entry 

This section describes the procedures for generating a version of POWER, 
without the RJE option. The procedure consists of six steps, which fall 
into two categories (see Figure 2-3). 

• steps 1 and 2 define the contents of your version of POWER. 

• Steps 3 through 6 show how the program is assembled, cataloged, and 
link-edited. 

Prior to step 1, ensure that your DOS/VS supervisor has keen generated with 
POWER=YES and that sufficient logical unit blocks (LUBs) have been 
generated for the POWER partition. 



Step 1 

The aim of Step 1 is to determine the functions POWER is to include, to 
define the storage resources required, and to establish which POWER 
parameters and supervisor generation macros are affected. 

• Determine what disk space the central installation car provide for 
POWER. 

• Decide which partition POWER will occupy, what partitions it will 
support and how many reader and writer routines may be active at one 
time. 

• Check the number of logical unit block (LUBs) available for the POWER 
partition. POWER requires one LUB (SYSOOl) for the QFILE, one for each 
DATAFIL module (SYS002, ...), and one for each active reader/writer 
routine. An extra LUB is required for each tape device that is to be 
used for tape spooling. The SYSOOO LUB will be used hy the POWER 
accounting file ACCTFIL. The smallest number of LUBs required for the 
POWER partition may be determined as follows: 

2 + NUMDDKS + MAXCCB 

The number of LUBs is specified in the BGPGR or FnPGR parameter of the 
lOTAB supervisor generation macro. 

• For each partition supported by a reader/writer POWER system, three PUB 
entries must be reserved for dummy device addresses; for a writer-only 

N system, two PUB entries must be reserved. This has tc be covered in the 
•' lODEV parameter of the lOTAB macro. 
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I 



STEP1 



Determine 
resources for and 
uses of POWER 



STEP 2 



Select options 
for generating 
POWER 



STEPS 



Based on selections 
verify that 
resources are 
available 




O 



STEP 4 

Assemble and 
link-edit POWER 
as defined in 
step 2 



STEP 5 



Check link-edit 
step 4 of POWER 



STEP 6 



Prepare and 
Carry out POWER 
startup 
procedures 



Figure 2-3. POWER Program Generation Steps 



Step 2 



Examine the POWER program generation parameters in detail. The particular 
requirements of your installation must now be translated into the POWER 
macro options that will define the POWER program (use a copy of Figure 2-4, 
which is provided to help you select the parameters you require) . 
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step 3 

To this point nothing has been generated yet, tut you have described in 
detail the contents of your POWER program. You must now verify that the 
available system resources (disk and partition space) ireet the requireirents 
of your POWER design. 

For more detailed information on disk and partition size requirements, 
refer to the section "Generating a Version cf POWER" in the DOS/VS System 
Mana gem ent Guide , GC33-5371. 

To estimate the size of ycur proposed POWER program,, use the tables with 
the macro parameters which are shown in Figure 2-5. If there are no 
conflicts, between the requirements of your design and the resources 
available, you are ready to proceed to Step 4 and begin the final 
generation process. If there are conflicts, resolve them before 
proceeding. You may wish to return to Step 2 tc reselect POWER macrc 
operands, or even return to Step 1 for a restatement of resources and 
proposed use of the POWER system. 



Step 4 

Now assemble and link-edit the POWER macro with the operands selected in 
Step 2. In addition, link-edit the POWER overlay phases which are 
contained in your relocatable library and store them in the system, cere 
image library. (See Figure 2-6). The link-edited POWER macro together 
with the overlay phases constitute the POWER system. 

Examples of how to assemible and link-edit a small writer-only POWER 
system and a small reader/writer POWER system are shown in Figure 2-9 and 
in Figure 2-11, respectively. 



Step 5 

Check the SYSLST output of Step 4 to verify that it has been completed 
successfully. The listings and the card deck should be saved for future 
reference. 



Step 6 

The POWER system should now be ready for use. Carry out the startup 
procedures described in DOS/VS Operating Procedures, GC33-5378, and run 
some test jobs to verify that the program has been installed successfully, 
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col. 1 



col. lOCol. 16 



Col. 72 



,M r^ r^ 

|user-naine|POWER |DISK= 

L X ^ 



'r-^ 



-+-^ 



DBLK= 

MAXJOBS= 

NUMDDKS= 

NTRKGP= 

TRACKGP= 



ACCOUNT= 



ADDITR= 
AUTOSTR= 



JOBSEP= 
LINETAB= 



MAXBUFS= 
MAXCCB= 



MAXRW= 
POWPART= 



PRIORTY= 
RDRCLOS= 



READER= 
SLI = 



STDCARD= 
STDLINE= 



SUBLIB= 
TAPE= 



MAXRJS= 



RETRY= 
RJEND= 



DIAG= 



-+-^ 









4-1 






-+-■1 

4-f 
4-1 



-1-^ 



4-1 
4-1 
4-1 



-1-1 
-+-1 
-+-1 
-+-1 



4-1 
4-1 

4-1 

4-1 

4-1 
4-1 

4-1 



END 



.x_j 



Figure 2-4. POWER Parameters 



196 DOS/VS System Generation 



T T T 

I Bytes Required | Parameter Option) 

Parameter or | (Value cr Fcrmula) j- t -j Result in 

Component |Reader=NO|Reader=YES JDefault | Chosen |Bytes 
4 J. + 4 4 

DOS/VS Save Area | 120 | - I - I 120 
4 4 4 4 

Console Cornirand | III 
Processor j l,02i» | - I - I 1,02U 
4 ^ 4 4^ 4 

Basic POWER Code j 12,400 j 13, 800 |reaDER= j | 

I I I YES I I 

4 4 4 4 4 

ACCOUNT=YES | 200 | 24 | NO j | 

4 X 4_ 4 4 

AUTOSTR I III 

1 Device | 36 j | | 

2 Devices | 60 1*1 I 

3 Devices j 84 | | | 
4 _ 4 4 4 

DBLK=d I see MAXBUFS | - I " I 

4 4 4 4 

D3540=INPUT j - 164 | - I " I 164 

4 4 4 4 

LINETAB I III 
First Partition | 200 I - I I 
Each Additional | 26 | | | 
Partition j III 
^.^ ^ .-_4 4 4 4 

MAXJOBS=n /6WG?r'L!r/| n | 110 | | 

4 4 4 4 

MAXBUFS=n I n ♦ d | 7 j | 

DBLK=d 1 I 1,024 1 | 

4 4 4 4 

MAXCCB=n j n * 36 | 3 j | 

4 4 4 4 

MAXRW=n I n * 1,024 [ 3 | | 

, 4 4 4 4 

NTRKGP=n see Notej C5+n/8) * (l+3p) |/y^,g,„,200 j | 

NUMDDKS=n I n * 96 | 1 1 | 

4 ^ 4 4 4 

PRIORTY*NO j - I 22 4 I NO | | 

4 4 _4 4 4 

SLI II III 
First Partition | - | 1,600 | NO | | 
Each Additional | | 34 | | | 
Partition j | | | | 
4 i. 4 4 4 

TAPE=yES 1 1,350 | NO | | 

4 4_ 4 4 

DIAG=YES I 400 | NO | | 

4 4 4 4 

POWPART= see Note | (p-1) * 700 | EG | | 
(partition,...) | III 
4 4 4 4 

Total for POWER | | | | 

Without RJE= I III 



L J. . X J. J. J 



Note: p = number of partitions supported. 

Figure 2-5, Parameters and Coitiponents Affecting the Size of the POWER 
Program (Part 1 of 2) 
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T T- 

Parameter Option 

j. ^ ^ Result in 

Default jChcsenlBytes 



I Parameter or 
I Component 
I- 



Bytes Required 
(Value or Fcrmula) 
Reader=NO |Reader=YES 

J. 



J MAXRJS=n 
h 



(3 * n + 5)*1,024 



I RJETMOD 

I BSCTST=NO , SWITCH=NO 

I BSCTST=NO , SWITCH=YES 

! BSCTST=YES , SWITCH=NO 

I BSCTST=YES , SWITCH=YES 

h 



11,300 
13,300 
15,100 
17,100 



. RJELKLST 

j Number of Lines is n 

y 

j RJUSERS 

I Number of Entries 

lis n 

^ +. 

I Total for POWER RJE I 
L Jl. 



24 + 16 ♦ n 



24 + 16 * n 



Not e: p = number of partitions supported. 

Figure 2-5. Parameters and Components Affecting the Size of the POWER 
Program (Part 2 of 2) 
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POWER 
Program 
Assembly 



Control 
Cards Plus 
Generation 
Parameters 



POWER 
Object Deck 



DOS/VS 
Source 
Statement 
Library 



Power 
and 
System 
Macros 



DOS/VS 

Assembler 

and 

Linkage Editor 



Core 

Image 

Library 



POWER 
Overlay 
Phases 



DOS/VS 
Reloca- 
table 
Library 



DOS/VS 
Linkage 
Editor 



DOS/VS 

System 

Core 

Image 

Library 



Figure 2-6. 
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GENERATING A SMALL WRITER-ONLY POWER SYSTEM 



This part shows a small writer-cnly POWER systern, POWERl, and its 
generation. 



Disk Storage Requirements, Functions, and Supervisor Prereq uisites 

Two tracks for file QFILE, and 100 cylinders for the file DATAFILE, en one 
IBM 3330 disk pack are used. 

FOWERl services one partition, the background, and supports one punch 
and one printer. 

The supervisor under which POWERl is to run irust have been generated 
with POWER=YES. 

For the PCWER-resident partition, five LUB entries are required. For 
the POWER- supported partition, two PUB entries (one for the printer and one 
for the punch) must be reserved for dummy device addresses. 

Figure 2-7 shows the paraireter cpticns for FOWERl. The values chosen 
constitute a close to minimuir POWER; only the parameters AUTOSTR and 
LINETAB could be omitted and the value of DBLK could be reduced to save 
real storage space. 

For an explanation of the individual parameters and options, refer back 
to the part "POWER Program Generation Parameters". 

Before assembling the POWER program, you can estimate its size. Figure 
2-8 shows an application of the estimation table 2-5 for POWERl. It 
contains the parameters that affect the size of a POWER program and the 
formulas for calculating the space needed. Where applicable, the table 
also includes the default values fcr the individual options. 

The options chosen for POWERl are inserted under the heading "Parameter 
Options Chosen"; the resulting values are placed under "Result in Bytes". 

The size of the partition needed to acccirmcdate POWERl, a small 
writer-only system, is 18K bytes. 



Assembling and Lin k-Ed iting PO WERl 

Figure 2-9 shows (a) how to assemble and link-edit the POWER macro and its 
selected operands and (b) how to link-edit the POWER overlay phases that 
are contained in the relocatable library. The link-edited POWER macro and 
the POWER overlay phases constitute POWER ready for execution. How POWER 
may be started is shown under "Start POWER". 

The example is valid only for a supervisor generated with the relocating 
loader (RELLDR=YES) . How to link-edit a POWER system for a supervisor 
without relocating loader is shown under "Link-Editing POWER for a 
Supervisor without Relocating Loader". 
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col. 1 col. 10 Col. 16 



Col. 72 



rf ^f ^f 

IPOWERI 1 POWER |DISK=3330, 
L X , 



* I 

+H 

* I 

-^ 

-^ 

-•f 
*\ 

-^ 

-■f 

H 
-^ 

+H 

-■f 

* I 

-■1 

* I 
-■! 

ic I 

-■! 

* I 

-^ 

*i 

-I 
-■f 

-■! 
-•f 
-■I 
-^ 

-^ 

-^ 

-^ 

-^ 

4H 

-JL-J 



DBLK=528, 



iyiAXJCBS = 50, 



NUMDDKS=1, 



NTRKGP=300, 



TRACKGP=6, 



ACCOUNT=/ 



ADDITR=/ 



AUTOSTR=(,,OOE,1,OOD,11) , 



D3540=/ 



JOBSEP=NO, 



LINETAB=( 10, 00, 05, 10, 15, 20, 2 5, 30, 3 5, 4 0,45,50, 55) , 



MAXB0FS=5, 



MAXCCB=2, 



MAXRW=2, 



POWPART=BG, 



PRIORTy=/ 



RDRCLOS=/ 



READER=NC 



SLI=/ 



STDCARD=/ 



STDLINE=/ 



SUBLIB=/ 



TAPE=/ 



!yiAXRJS=/ 



RETRY=/ 



RJEND=/ 



DIAG=/ 



■T 

I END 
-i X 



-+ 



-+ 



Figure 2-7. Parameter Options Chosen for a POWERl, or Sirall Writer-Only 
Version of POWER 
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T T 

Paraireter Option 



Parameter or 
Component 



Bytes Required 
(Value or Formula) 
Reader=NO | Reader=YES 

X 



Default 



Chosen 



Result in 
Bytes 



DOS/VS Save Area 



120 



120 



Console Command 
Processor 



l,02tl 



1,024 



113,800 



Basic POWER Code 



12,400 



READER: 
YES 



NO 



12.400 



ACCOUNT=YES 



200 



240 



NO 



NO 



AUTOSTR 

1 Device 

2 Devices 

3 Devices 



36 
60 
84 



2 

de- 
vices 



60 



DBLK=d 



see MAXBUFS 



■i 



LINETAB 

First Partition 
Each Additional 
PARTITION 



200 
260 



1 
part. 



200 
50 



MAXJOBS=n 



110 



50 



MAXBUFS=n 
DBLK=d 



n * d 



|I 

j. 

MAXRW=n 

NTRKGP=n see Note 



7 
1,024 



5 
528 



2,640 
72 



^ 
- — -f 

2,048] 
^ 

172 



MAXCCB=n 



n * 36 



3 
3 
200 



n * 1,024 
(5+n/8) ♦ (l+3p) 






2 
f 

300 



NUMDDKS=n 



n * 96 



1 
NO 



96 



PRIORTY*NO 



224 



NO 



SLI 

First Partition 
Each Additional 
Partition 

TAPE=YES 
|. 

DIAG=YES 
j. 






I 1,600 
I 340 
I 

1,350 



NO 






4 

NO 



NO 



—4 

NO 






400 



NO 



NO 



POWPART= see Note 
(partition,. . .) 



(p-1) * 700 



EG 



BG 



^ 



Total for POWER 
without RJE 



18,882 



Note; p = number of partitions supported. 

Figure 2-8. Real Storage Estimates for a 
POWER 



Small Writer-Only Version of 
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I 



GENERATING A SMALL READER/WRITER POWER SYSTEM 



This part shows a small reader/writer POWER system, P0WER2,, and its 
generation. 



Di sk St orage Requirements ^ Functions , and Supervi sor Prerequisit es 

Two tracks for the file QFILE, and 100 cylinders for the file DATAFILE, on 
one IBM 3330 disk pack are used, just as for PCWERl. 

P0WER2 services one partition, the background, and supports one reader, 
one punch, and one printer. The supervisor under which F0WER2 is to run 
must have been generated with POWER=YES. 

For the POWER-resident partition, six LUB entries are required. For the 
background partition, three PUB entries (one for the reader,, one for the 
punch, and one for the printer) must be reserved for duiriry device 
addresses. 

Figure 2-11 shows the parameter options chosen for P0WER2. The values 
chosen constitute a close to miniirum POWER; only the parameters AUTOSTR and 
LINETAB could be omitted and the value of DELK could be reduced to save 
real storage space. For an explanation of the individual parameters, refer 
to "POWER Program Generation Parameters". 



Real Storage Estimates for P0WER2 

Figure 2-10 contains the parameter options that affect the program; size of 
P0WER2 and the corresponding real storage requirements. The size of the 
I real partition that is to contain P0WER2 must be 22K bytes. See also 
"Total Size of the POWER Partition". 



Assembling and Link-Editing POWER 2 

Figure 2-11 shows how to assemble and link-edit P0WER2. Assembly and 
link-editing are the same as for POWERl, except that the POWER macro 
options are partly different. 

This example, too, is valid only for a supervisor generated with the 
relocating loader (RELLDR=YES) . How to link-edit a POWER system for a 
supervisor without relocating loader is shown under "Link-Editing POWER for 
a Supervisor Without Relocating Loader". 
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Without RJE= 
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Note: p = number of partitions supported. 

Figure 2-10. Real Storage Estimates for a Small Reader/Writer Version of 
POWER 
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Generating POWER with Remote Job Entry (RJE) 

I POWER RJE is an extension of POWER without RJE. Ycu should know how to 
generate POWER without RJE before reading this section. 

The generation procedure for POWER with Remcte Jot Entry consists of 8 

(steps. The DOS/VS supervisor must have been generated with POWER=YES. 
Make sure that the central system and the telecommunications network meet 
the hardware specifications described in the first part cf this section. 

I Steps 1 through 4 involve defining the contents of your POWER system and 
the central system resources that may be allocated to the POWER system. 
Steps 5 through 8 describe assemibling, cataloging, and link-editing the 
system. You may find Figure 2-12 a helpful outline of the 8 steps. 



STEP1 



Determine system 
resources for 
support of 
POWER RJE 



STEP 2 



Determine POWER 
RJE macro 
operands to be 
selected 



STEP 3 



Determine RJE 

components 

options 



STEP 4 



Verify that 
selected operands 
and system resour- 
ces meet your 
requirements 



6 




Generate and 
catalog RJE 
components as 
defined in step 3 



STEP 6 



Generate POWER 
RJE as defined 
in step 2 



STEP 7 



Check link-edit list 
of steps 5 and 6 



STEPS 



Vsrif*' suGC<?s?fiil 
generation by per- 
forming POWER/RJE 
startup 



Figure 2-12. POWER RJE System Generation Steps 
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step 1 

Determine if your installation ireets the prograiriring requirements stated 
under "Programming Requirements" in this section. Determine what disk 
space has to be provided for POWER, which partition POWER will occupy, and 
how many LUBs and PUBs are needed. The smallest number cf LUBs required 
for the POWER partition is: 

2 + NUMDDKS + MAXCCB + MAXRJS 

See the DOS/VS System Management Guide, GC33-5371, for POWER generation 
requirements. 

Step 2 

Examine in detail the section POWER Program Generation Parameters. The 
particular requirements of your installation must now be translated into 
the POWER macro options that define the POWER program (use a copy of Figure 
2-4„ which is provided to help you select the parameters you require). 

Step 3 

You must now describe the telecommunication system in terms of the RJE 
components explained under "RJE Components Generation". You should alsc 
establish user and terminal identification names for terminals and terminal 
users who will be authorized to use the RJE system. The required RJE block 
names will be dictated by the RJE blocks needed. However, you may alsc 
plan for expansion by using names cf RJE blocks which may be added later. 
How the appropriate additional RJE blocks are later added to the system is 
discussed under "Modifying the RJE Block Name List and RJE Blocks". 

Step 4 

You have now described in detail what your POWER system will contain. You 
should now verify that the available system resources, disk and partition 
space are sufficient for the POWER system you have designed. Using the 
table shown in Figure 2-5, you can estimate the size of the proposed POWER 
RJE system. If there are no conflicts, proceed to step 5 and begin the 
final generation process. If there are conflicts, resolve them before 
proceeding. You may wish to return to Step 2 to reselect POWER macrc 
operands or even return to Step 1 for a restatement of resources and 
proposed use of the POWER system. 

Step 5 

Assemble the RJE components listed below and catalog them into the 
relocatable library with the MAINT program: 

RJBTMOD 

RJBLKLST 

RJUSERS 

In addition, each RJEBLK should be assembled and link-edited at this time. 
Figure 2-13 and a review of the RJE component generation will help ycu to 
complete this step. 

Check the assembly listings and the MAINT output to ensure successful 
execution of Step 5, 
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step 6 

You are now ready to assemble the POWER iracro with the selected operands 
(see Figure 2-15). The output of this assembly has to be link-edited, that 
is, the modules RJBTMOD, RJBLKLST, and RJUSERS have to be linked together 
with the POWER module to obtain the resident part of POWER RJE. 

At this time, the POWER and POWER RJE overlay phases have to be 
link-edited, too. 

Step 7 

Check the SYSLST output to verify that Steps 5 and 6 have been completed 
successfully. Save the listings and the card decks for possible future 
reference. 

Step 8 

The POWER RJE system should now be ready for use. Carry out the startup 
procedures described in D OS/VS Operat ing Proc edur es , GC33-5378, and run 
some test jobs to verify that the POWER system has been installed 
successfully. 
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Figure 2-13. Generating the POWER RJE Components 
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RJE COMPONENTS GENERATION 

POWER RJE generation produces five basic coitiponents: 

POWER program 
special ETMOD 
RJE blocks 
RJE block name list 
userid list. 

The BTMOD, the RJE block name list, and the userid list must be placed intc 
the DOS/VS relocatable library prior to link-editing POWER RJE (see Figure 
2-13 and Figure 2-14). 

The POWER program is generated by specifying the RJE operands in 
addition to the parameters for the central system requirements in the POWER 
macro. For a description of the RJE operands, see "RJE Management". The 
generation of the other components is described below. 

Each component is assembled separately. Note that nc embedded blanks 
are permitted in any operand or operand sublist. 



BTMOD Generation 

The BTMOD required for POWER RJE is generated by assembling the macrc 
RJBTMOD,, which must not be labeled. This BTMOD is always given the name 
RJBTMOD. RJBTMOD has two operands which are used to generate the ETMOD: 

SWITCH=|yEs| yes indicates that logic fcr switched lines is 
( NO) to be included in the BTAM module. 

BSCTEST=[yes1 yes specifies that logic for the BSC online 

NO) terminal test is to be included in the BTAM module. 

Information on BTMOD and on-line testing is contained 
in DOS/VS B asic T elecomunications Method , GC27-6989. 
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Figure 2-14. POWER RJE Program Assembly and Link-Editing 
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Default values are assumed for five additional ETMCD parameters as follows: 

ERLOGIC=YES 

CANCEL=NO 

BSCS=YES 

DECBEXT=NO 

SEPASM=YES 

The POWER RJE BTMOD can be generated as fcllcws: 

// JOB ASSEMBLE RJE BTMOD 
// OPTION DECK 
// EXEC ASSEMBLY 

RJBTMOD BSCTEST=NC,SWITCH=YES 

END 
/* 
/S 

The object deck will contain the proper CATALR statement for placing the 
RJE BTMOD in the relocatable library. With the following job you will 
place this deck into the relocatable library: 

// JOB CATALOG RJE BTMOD INTO THE RELOCATABLE LIBRARY 
// EXEC MAINT 

punched output from RJBTMOD assembly 
/* 
/6 



RJE Block Gener atio n 

The RJE block defines the device-dependent characteristics of a 
teleprocessing line and contains the DECB, DTFET, I/O area, and additional 
device-dependent characteristics required tc access the terminal type en 
that line. The name for each RJE block is created in the following format ; 

Dcuutype 

Where 

cuu is the line address at the central installation, and 

type specifies the terminal type in the following form: 



buffer size = 128 
buffer size = 256 
buffer size = 512 



D0302770 is the RJE blockname when the line address is 030 and the terminal 
is a 2770 with buffer size = 128. 

During RJE routine initiation, the DTFBT in the RJE block is assigned a 
logical unit number by POWER which is dynamically assigned to the PUB 
representing the specified line. Therefore, DOS/VS ASSGN statements are 
not required and line groups are not permitted. 

An RJE block is generated by assembling the macro RJEELK, which must not 
be labeled. RJEBLK is specified with the following operands, which are 
used to generate a DTFBT internal to the RJE block (For details on the 
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2780 


for 


a 


2780 


terminal 


3780 


for 


a 


3780 


terminal 


2770 


for 


a 


2770 


terminal 


277A 


for 


a 


2770 


terminal 


277B 


for 


a 


2770 


terminal 


Example: 











parameters TERMTST, CU, MODELST, and RETRY, refer to DOS/VS Basic 
Telecommunications Ac cess Metho d, GC27-6 98 9. 



CHAN=cuu 



switch= j yes 
'no 



cuu is the line address at the central installation and 
is specified as a three-digit hexadecimal nuirber. 

YES indicates that the terminal is on a switched 
line. NO indicates that the terminal is on a 
non-switched line. 



{2780 

DEVICE={2770 

3780 



128 

BUFSIZE={256 

512 



DEVICE specifies the type cf terminal the RJE block is 
to support. 2780, 2770, or 3780 may be specified. 



BUFSIZE specifies the buffer size of a 2770 terraihal. 



TERMTST=(yesJ YES specifies that the DTFET will contain the 

( NO J test activation code necessary to perform online 
terminal tests. 

CU=J2701J as specified fcr the DTFBT. 
l2703j 



M0DELST=J5l 
J. 



(see note below) 



RETRY=17 
n 



Retry count fcr the DTFET. n may be any 
number from through 15. 



Each RJE block must be assembled separately to avoid duplicate labels. 

The values specified for DEVICE and BUFSIZE may be changed from the 
terminal during POWER execution by specifying the necessary values in the 
RJSTART card. 

N ot e; The MODELST operand of the DTFBT is used to set conditions in the 

SDA-II adapter of the 2701 at line initialization (open) time. The 
three conditions set are the EIE (error information byte) mode, dual 
communication interface, and dual code feature. The dual 
communication interface and dual code settings are determined by the 
2701 hardware configuration. EIB or non-EIB mode may be selected by 
the EIB mode option. In EIE mode, an error-information byte is 
placed in storage by the 2701, following each unit separator (US) 
character, EIB character, or STX character. 

The 80-byte card records from the 2780 (with m^ultiple record 
transmission with transparency) that are placed in storage by the 2701 with 
EIB mode on, appear as: 

|D|S| I |E|D|S| I |E|D|S| I IE|D|S| |E|E| 

JL|T|text 1 |U|I|L|T|text 2 |U| I |L|T| text 3 | U| I|L| T| text 4 |I|I| 
|E|X|(80 bytes) |S|B|E1X| (80 bytes) |S |B|E|X | (80 bytes) |S |E |E |X| (80 bytes) |B|BJ 

L«X-X X_X».X_X_X L-.X_J.-.X-.X J._a-JL_X-X X-X-J 

DLE, STX„ US, and EIB are one-byte characters. 

Notice that the first byte of each successive record is 8U bytes from, the 
first byte of the preceding record. 
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With non-EIB mode, records appear as follows: 

|D|S| I |D|D1 I |D|S| I |D|S1 |E| 

|L|T|text 1 |U|L|T|text 2 |U|LiT|text 3 |U|L|T|text U |I| 
|E|X|(80 bytes) ISIEJXI (80 bytes) | S |E| X| (80 bytes) | S| E| xj (80 bytes) |B| 

L-X-X X_X_X_X , X~X_X_X X_X_X_X X_J 

Here, only 83 bytes separate the first byte of each record from the first 
byte of the preceding record. 

POWER RJE assumes that the EIB byte is present when the records are read 
by the 2701. For this reason MODELST must be specified as follows: 

'4 
M0DELST=)5i 
16 
7, 

A sample assembly and link job follows: 

I // JOB ASSEMBLE AND LINK RJE BLOCK FOR LINE 023, TERMINAL 27 80 
// OPTION DECK 
// OPTION CATAL 
// EXEC ASSEMBLY 

RJEBLK CHAN=023,SWITCH=NO,MODELST=(U) 

END 
/* 

// EXEC LNKEDT 
/£ 

Note: Each RJEBLK must be link-edited separately. The two unresolved 
external symbols RJBTNOD and IJLDTIH will be resolved when the 
RJEBLK is initiated at RJE routine startup. 



RJE Block Name List Generation 

The RJE block name list must contain the name cf each RJE block t o he use d. 
It is generated by assembling the iracrc RJELKLST, which irust not be 
I labeled. RJBLKLST is specified with operands cf the following f orirat: 

BNLSTn=(blockname[,blockname,blockname,. . . . ,blocknaire] ) 

where blockname is the eight-character name generated for each RJE block 
and n is a numeric character from 1 through 8. The BNLSTn parameter may be 
specified in any order (for blockname format see "RJE Block Generation"). 

The maximum number of block names per parameter is 14. The maximum number 
of block names is 100. At least one BNLSTn param.eter must be specified. 
If only one block name is specified, no parentheses are required. 

The RJBLKLST macro expansion is a list containing the names of the RJE 
blocks specified. The POWER RJE initiation routine checks that each entry 
\ has a corresponding block in the cere image library. Thus POWER RJE always 

^ obtains an up-to-date list of the RJE blocks available. 
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I 



An example of a job to asseirble an RJBLKLST follows: 

// JOB ASSEMBLE RJBLKLST (LIST OF RJEBLK NAMES) 
// OPTION DECK 
// EXEC ASSEMBLY 

RJBLKLST BNLST1=(D031277E) ,ENLST5= (00312780,00332780), x 
BNLST4= (00302780,003227 80,003 4278 0) 

END 
/♦ 
/S 

The object deck produced by assembling RJBLKLST contains the proper CATALR 
statement for placing the RJBLKLST in the relocatable library by the 
following job: 

// JOB CATALOG RJBLKLST (LIST OF RJEBLK NAMES) 
// EXEC MAINT 

punched output from RJBLKLST assembly 
/* 
/6 



Modifying the RJE Bl ock Name List and RJE Blocks 

The RJE block name list may require modification whenever RJE blocks are 
added to or removed from POWER 

If you want to add to POWER an RJE block whose name is already contained 
in the RJBLKLST list, you have only to catalog the new RJEBLK object mcdule 
I into the core image library before you start POWER again; you need not 
re-link your POWER (see Figure 2-13). 

If you want to delete an RJE block, delete the RJEBLK from the core 
image library. No RJE block should be deleted, however, while POWER is 
operational. 

If you want to add an RJE block and the RJBLKLST list has to be updated 
accordingly, besides generating and linking the new RJEEIKS to the cere 
image library, you have to re-link your POWER after you have cataloged the 
new RJBLKLST object module into the relocatable library (see Steps 5 and 6 
in this part) . 



Userid List Generation 

The userid list contains the user identification (userid) for all 
authorized RJE users. Termids are also contained in this list. Teririds 
and userids are not distinguished in this list. The userid list is 
generated by assembling the macro RJUSERS, which must not be labeled. 
RJUSERS is specified with the following operands: 

LISTn= (useridt , userid, userid , . . . . , userid] ) 

where n is a numeric character from 1 through 8. 

userid may be from 1 to 8 alphameric characters; embedded blanks are not 
permitted. Use of "ALL" or "ALLUSERS" as a userid is not permitted. 

The number of userids specified in a LISTn keyword parameter sublist is 
restricted to 128 characters (including parentheses and commas) per 
sublist. The maximum number of userids is 100. Duplicate userids are not 
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checked, and only the first cf duplicate userids is used during POWER 
program execution. 

The LISTn keyword parameters may be specified in any order. At least 
one LISTn keyword parameter must be specified. 

An example of a job to assemble a user list follows: 

// JOB ASSEMBLE RJUSERS (LIST OF VALID RJE USERS) 

// OPTION DECK 

// EXEC ASSEMBLY 

RJUSERS LIST1= (NEWYORK, CHICAGO, TULSA, ATLANTA) , x 

LIST5= (PAYROLL, TAXDEPT,ENGR), x 

LIST7= (SALES, HQ, FINANCE, DP) , x 

LIST8=(WAREHS1,WAREHS2,\nAREHS3) , x 

LIST3=(DIST1,DIST2,DIST3,DIST4) 
END 

/♦ 

/6 

The object deck produced by assembling RJUSERS contains the proper CATALR 
statement for placing RJUSERS into the relocatable library by the fcllcwing 
job: 

// JOB CATALOG RJUSERS 
// EXEC MAINT 

punched output from RJUSERS assembly 
/* 
/& 

MODIFYING THE USERID LIST 

Userids may be added to or deleted from the userid list with the LISTn 
parameter of the RJUSERS macro. The RJUSERS m.acrc is then reassembled and 
placed into the relocatable library. Finally, POWER is again link-edited. 

After changing the userid list, a ccld start of POWER is necessary to 
update your message queue. 



GENERATING A SMALL POWER RJE SYSTEM 



This part shows a small version of POWER with RJE, POWERS, and its 
generation. 



Disk Storage Requirem ent s ^ F unctions ^ and Supervisor Prerequisit es 

Four tracks for the file QFILE, and 100 cylinders for the file DATAFILE, on 
one IBM 3330 disk pack are used. 

P0WER3 services one partition, the background, and supports one reader, 
one printer J and one punch, as well as two 278 terminals that may be 
accessed one at a time by eight users in two different locations. 

The supervisor must have been generated with POWER=YES. 

For the POWER-resident partition,, seven LUB entries 
(2+NUMDDKS+MAXCCB+MAXRJS) are required. For the background partition, 
three PUB entries (one for the printer, one for the punch, and one for the 
reader) must be reserved for dummy device addresses. 
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Figure 2-15 shows the parameter options chosen for PCWER3. The values 
chosen constitute a close to miniitium POWER; only the parameters AUTOSTP and 
LINETAB could have been omitted. 

For an explanation of the individual parameters, refer to 'POWER Prcgrair 
Generation Parameters'. 



RJE components and Their Gen eration 



The RJE components required for P0WER3 are: 

• one RJE block for the two terminals 

• one POWER RJE BTMOD 

• one RJE block name list for the two RJE blocks 

• the userid list for eight users in two locations. 
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col. 1 Col. lOCol. 16 

I |user-naine|PCWER |DISK=3330, 



|DBLK=528, 



Col. 72 



T-1 



MAXJOBS=100, 



NUMDDKS=1, 
NTRKGP=6 00, 
TRACKGP=3, 



ACCOUNT=/ 



ADDITR=/ 
AUTOSTR=(00C,l,00E,l,00D,12) , 



D35U0=/ 
JOBSEP=YES, 



LINETAB= (10, 00, 05, 10, 15, 20, 25, 30, 35, a 0,45, 50, 55), 
MAXBUFS=9, 



MAXCCB=3, 
MAXRW=3, 



POWPART=BG, 
PRI0RTY=5, 



RDRCLOS=EXIT, 
READER=YES, 



SLI=NO, 
STDCARD=/ 



STDLINE=/ 

SUBLIB=/ 

TAPE=/ 



MAXRJS=1, 



RETRY=6 , 
RJEND=NO 



DIAG=/ 



END 



-+ 



-4-f 



-+ 
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♦ 
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Figure 2-15. Parameter Option Chosen for a Small Version of POWER with RJE 
That Services Cne Partition and Supports Cne Terminal 
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The special BTMOD, the RJE block name list, and the userid list are 
assembled separately and then cataloged into the relocatable library (see 
Figure 2-13) from where they are fetched when POWERS is assembled and 
link-edited (see Figure 2-14 and Figure 2-15). 

RJE BLOCK 

The RJE blocks required for POWERS are assembled and link-edited into the 
system core image library as follows (see also Figure 2-13): 

// JOB ASSEMBLE RJEBLK AND LINK IT 
// OPTION CATAL 
// OPTION DECK 
// EXEC ASSEMBLY 

RJEBLK CHAN=060,SWITCH=NO,MODELST=(4) 

END 
/* 

// EXEC LNKEDT 
/6 

The second RJEBLK macro (RJEBLK CHAN=061,SWITCH=NO,MODELST= (a) , is 
assembled with the same card deck. 

BTMOD 

Assembling and cataloging of BTMOE for two 2780 terminals is as follows: 

// JOB ASSEMBLE RJBTMOD 
// OPTION DECK 
// EXEC ASSEMBLY 

RJBTMOD BSCTEST=NO,SWITCH=NO 

END 
/* 
/g 

// JOB CATALOG RJBTMOD INTO RELOCATABLE LIBRARY 
// EXEC MAINT 

punched output from RJBTMOD assembly 

/* 
/6 

RJE BLOCK NAME LIST 

Assembling and cataloging of the RJE block name list for POWERS into the 
relocatable library is as fellows: 

// JOB ASSEMBLE RJBLKLST (LIST OF RJEBLK NAMES) 
// OPTION DECK 
// EXEC ASSEMBLY 

RJBLKLST BNLST1=(D0602780,D0612780) 

END 
/♦ 
/S 

// JOB CATALOG RJBLKLST INTO RELOCATABLE LIBRARY 
// EXEC MAINT 



punched output from RJBLKLST assembly 
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/* 
/g 



USERID LIST 

The userid list for POWERS contains eight userids and t\<c termids. 
Assembly and cataloging of the userid list is shown below: 

// JOB ASSEMBLE USERID (LIST OF ALL VALID RJE USERS) 

// OPTION DECK 

// EXEC ASSEMBLY 

RUSERS LIST1= (CHICAGO, LONDON) , X 

LIST2=( SMITH, JOHNSON, EDWARDS, x 

NEUHAUS, ERNST, MATSUMI, x 

WEBER, GILLOT) 
END 

/* 

/6 



// JOB CATALOG USERID LIST 
// EXEC MAINT 



punched output from RUSERS asseirbly 



/* 
/g 



Real Storage Estimate s for P0WER3 

Figure 2-16 contains the POWER parameters and the EJE coirponents that 
affect the size of POWERS. 

The size of the partition that is to contain POWERS irust be U2K bytes 



Assembli ng a nd Link-Editinc 

Figure 2-17 shows assembly and link-editing of POWERS (see also Figure 
2-14). The example is valid only for a supervisor with the relocating 
loader. How to link-edit a version of POWER for a supervisor without 
relocating loader is described under "Link-Editing POWER for a Supervisor 
Kithcut Rslocstin" Loader" _ 
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T T 

Parameter Option 

T 

Default iChcsen 



Parameter or 
Component 



Bytes Required 
(Value or Formula) 
Reader=NO | Reader=YES 

L 



Result in 
Bytes 



DOS/VS Save Area 



120 



120 



Console Command 
Processor 



f- 



1,024 



1,024 



Basic POWER Code 



12,400 113,800 



READER= 
YES 



YES 



13,800 



ACCOUNT=YES 



200 



240 



NC 



NO 



AUTOSTR 

1 Device 

2 Devices 

3 Devices 



36 
60 
84 



devices 



84 



DBLK=d 



see ^f!AXBUFS 



LINETAB 

First Partition 
Each Additional 
PARTITION 



200 
260 



1 
part. 



200 



MAXJOBS=n 



110 



100 



100 



MAXBUFS=n 
DBLK=d 



n * d 



h 
|I 

I" 

h 

j] 

f- 

ji 

I- 

PRIORTY*NO 

SLI 

First Partition 
Each Additional 
Partition 



7 

1,024 



528 



4,752 



iy!AXCCB=n 



n * 36 



108 



MAXRW=n 



n * 1,024 



3,072 



NTRKGP=n 



see Note 



(5+n/8) ♦ (l*3p) 



200 



600 



320 



NUMDDKS=n 



n * 96 



96 






224 

I 

I 1,600 

I 340 



NO 



NO 



YES 
NO 



224 



TAPE=YES 



1,350 



NO 



NO 



DIAG=YES 



400 



NO 



NO 



POWPART= see Note 
(partition, . . .) 



(p-1) ♦ 700 



EG 



BG 



Total for POWER 
Without RJE= 



23,900 



Note: p = number of partitions supported. 

2-16. Real Storage Estimates for a Small Version of POWER with RJE 
(Part 1 of 2) 



Figure 
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T T 

Parameter Option 



Parameter or 
Component 



Bytes Required 
(Value or Formula) 
Reader=NO | Reader=YES 



Default 



Chosen 



Result in 
Bytes 



MAXRJS=n 



(3 * n + 5)*l,02i» 



8,192 



RJETMOD 

BSCTST=NO , SWITCH=NO 
BSCTST=NO, SWITCH=YES 
BSCTST=YES , SWITCH=NO 
BSCTST=YES, SWITCH=YES 

RJELKLST 

Number of Lines is n 



11,100 
13,300 
15,100 
17,100 

24 + 16 ♦ n 



ESCTST 
=N0 



11,100 






56 



. RJUSERS 
[ j Number of Entries I 24 + 16 * n I - I 10 I 84 
■ is n 

I I Total for POWER RJE | 111 43, 332 1 

L X -, X X X J 



Note; p = number of partitions supported 

Figure 2-16. Real Storage Estimates for a Small Version of POWER with I^JE 
(Part 2 of 2) 



Module 2: Generating a Version of POWER — 574 5-SC-PWR 223 





•* 

b 

o 


* 




s 






















































- 


- 










































- 


^ D 






































s ^ 


1 H 


















































1 

o 

1 


ll 












































— 


--' 


























































































.. 


- 




























































X 


X 


> 


> 


X 


> 


X 


X 


?« 


X 


> 


X 


>< 


X 


X 


X 


y 


X 


X 








i 


s 

r 

8 

.1 
1 

0^ 
















































-- 




































































































































































































































































































- 
































% 


































- 














^ 


» 




— 




































in 














































u 














































N 









































—' 











^ 






































u 
















"' 






























« 














































w: 












































r 


















. ._ 


-— 


































' 










































•< 








- . . 














: 










" 




- 










■ 




















y 










































«< 






















'- 










"~ 
















¥ 










"' 


— 
































■^ 



















B 


O 2 




















t 










_._ 


— 


-- 




— 


— 






















^ 












u. 


ar D 
2 Z 


g" 




































' 




































•> 




W 






















t 




















x* 


% 




«< 




















— 


— 






















C 








■• 




































- 






-« 
























s. 


1 

c 
< 

Qi 

V 

Ul 

J 

1 

1 

1/: 

< 

ji 
•i 
u 

! 
J 

1 
1 

< 

< 
< 

J. 

1 
t 

• 

< 


J 
-> 






















x 




» 

























a 


Ul 


















C 








* 




















r- 


















-< 






1/ 






















^ 


(K 


















•«l 






- 
























>. 






















» 






^ 






















r 


ot 


















- 






^ 
























s 


u 




















•» 






























■3 


















u 








■> 
























c 


















■« 






If 








— 


















a 


















ie 






•^ 


k 










































» 






t 
























h 


















- 






-« 














































» 




-< 


1. 










• 














c 


















(. 








• 








1- 
















u 










*« 








-€ 






. ^ 


I 








- 












t 




1 








^ 


•« 


- 


' -^ 




. -^ 


• V 


' < 


- 




• 






• > 


a 








h 








- 


- 


-6 

If 


oe 


- - 


" 


TC 


- c 


— 


' cc 


u 




/ c 


■> 




u 


U! 


u 






■• 








II 


•sC 


II 


•1 


t 


7 


t 1 


1 


e< 




» 1 


1 


7 








" > 












tt 


d 


<t 


t 


t: 


a 


<i 


1- 


1 


a 


»! 


II 


«< 


7 


• 4 


1 




• I 


>J 


b 






J 






tt 


LC 


i. 


•* 


a 


V 


' H 


tf 


0. 


< 


U 


« 


II 


k 


C 


ct 


c 


If 


1 


1 












\ 


1 


C 


c 


V 


'■* 


If 


< 


u 


1- 


3 


Vi 


1 





J 


(1 


z 


r 


y 


- c 












:< 


r. 


c 


V 


(J 


c 


a 
1 


IT. 


kl 


< 


y) 


« 


C 


c 


C 


1 


oc 


a 


z 










J 


X 


t 


a 


4 


z 


y 


> 


>i 


- 


a 


< 


- 


>^ 


\- 


111 






< 






- 


cf 


< 


3 


h 


a 


J 


c 







< 


< 


< 


o: 





bl 


_ 


4 


k 


r 












C 


C 


i 


£ 


z 


h 


< 


o 


■ r 


J 


E 


« 


E 


ftJ 


od 


csd 


4fl 


S 


^ 


Q£ 






U 


J 


















































< 


•» 


« 












































d 


K 





Ui 












































Hi 


< 





3 

c 








































c 










































£ 




«r 






a 








































lu 




(T 


z 


7 














































•4 


c 


o 
















































- 
















































ce 


H 


»- 


•^ 












































o 


c 


QJ 


<^ 












































r 





o 


Ul 










































n 








"3 










































■ x 


__^ 




O 










































_^ 











































" f 





1 

3 
Z 

o 

s 




§ 


















■ 


^ 




?'^' 


1'^ 






















k 


S^' 




















\ 




7 ^ 






















\ 
























\ 




2 °- 






















1 


k 


X 
























\ 


























\ 






























\ 




z 

i 


S 

E 
J 

s 
s 

g 
1 

1 

1 
























\ 


























' 












































































































































































































— 




















1 


























/ 
























-- ■ 


/ 






























/ 
























J 


1 






















1 


























' 
























1 






i 


z 

ID 






















1 


























1 







.__.^. 


- 




- 


-- 












































~" 








--■ 


- 
































^ 






















' 




b 


' — 












VI 














1 


§■ 


z 

Z J3 

ii 










1^ 














L 


■g 










/ 














1 


h 










« 














1 


3 










s 














I 


o 










0. 














1 


< 


\ 

< 

< 

? 



u 

<] 
e- 

1 

<< 

< 
< 

III 
< 

e 
c 

i 
i 

< 

s 

S 
o 


■) 






















- 


-- 


I 


o 










7 


. 










M 










< 


























J 
















SI 










d 
















y 










u 
















n 










*? 














, 












c 














/ 


























/ 












l» 














/ 












r; 














/ 












OC 












1 


























/ 














« 












/ 












u 












/ 












•? 












/ 




- 


- 


.-.__ 






ft 












1 














f 
























1 








(_ 




c 












1 












z 












1 












< 












I 
























I 












« 




f- 








\ 












us 




d 








I 












5 


J 


C 


r 






I 








»- 




o 


< 


0^ 


d 


1- 




\ 













a 


V 


u 


c 


c 






L 








U 






< 


:^ 


u 


u 






I 






1- 


•SI 




« 


«J 


c 


1- 


■51 












- 


z 




e 




a 




r 






\ 






C 


J 






c 




n 


- 












_ 






J 





Id 


u 
















(J 



























•f 


■ u 




(9 


h 


3 


J 


ul 












d 


> 







a 


J 


J 


v 












J- 


U) 




n 





^; 





U) 








n 




£ 










C 


r 








' 


*•► 


Id 


*N. 


•« 


•V 


V 


H 


H 


•V 


04 


i 




*«s 




^ 


•«s 


-V 


V 






^ 


V 


y 





Figure 2-17, Assembly and Link-Editing a Srr.all Version of POWER with 
RJE 
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Local Testing of POWER/RJE 

RESTRICTIONS 

Successful installation of POWER RJE can be tested effectively only when 
a terminal is attached. However, a means for local testing has been 
provided for users who have a printer and an lEM 25U0 Card read punch 
attached to the central installation. This type of local testing will 
test only the ability of an RJE routine to function in the POWER 
environment; teleprocessing communications will not be tested, and 
DOS/VS BTAM support will not be used in the test. 

Instead, a printer and an IBM 25U0 will be accessed by the IO2540 
phase using PIOCS. This phase simulates, fcr the RJE routines, the 
operations performed by the IO27X0 phase which ncrirally interfaces with 
the BTMOD to perform teleprocessing input and output. During the test, 
local readers and writers must net be active. The test may begin at any 
point during POWER operation, and normal POWER operation may be resumed 
after the test is completed. Because the test serves tc test an RJE 
routine, only one routine can be activated during the test. 

TEST STARTUP 

The following DOS/VS job control statements should be included in the 
POWER partition initiation job control : 

// ASSGN SYSPCH,X'CUU' 
// ASSGN SYSLST,X'CUU' 

SYSPCH must be assigned to the IBM 2540 card read punch, and SYSLST must 
be assigned to a printer. The card reader will be assigned dynamically 
by the RJE start command processor. 

The POWER partition is started as specified in DOS/VS Operating 
Procedures,, GC 33-5378. No routine must be active at the beginning cf 
the test. Supported partitions may continue processing. 

To begin the test, the operator types the RJE option cf the start 
command as follows: 

S RJE,lineaddr, type, 2540, cuu 

Lineaddr and type have the same meaning during the test as they would 
when an RJE routine is being started. Lineaddr and type must specify a 
supported line and device type as they normally would. cuu specifies 
the address of the IBM 2540 card reader. For example, if 060 is a 
supported line in your POWER with RJE version, 2780 is the supported 
device type, and OOC is the IBM 2540 card reader, the command would be 
typed: 

S, RJE, 060,2780, 2540, OOC 

If the lineaddr and device type are incorrect^ the appropriate 
diagnostic messages will appear on the console typewriter as they would 
under nontest conditions. The 2540 positional operand indicates the 
request for local testing. 

The card reader must be readied to begin the test. During the test, 
messages appear on the console typewriter for the same reasons as they 
would in a nontest environment, and DOS/VS Mess ages, GC33-5379, should 
be consulted. 
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When the indicated RJE routine has been started successfully, the 
normal message 

1R2UI line address device type HAS BEEN STARTED 

will be issued. 



I TEST OPERATIONS 

When the routine has completed initialization, a read will be executed 
to the IBM 2540 card reader. The RJE routine v?ill expect input from the 
card reader to be in the saire forir that is required for an IBM 
I 2780/2770/3780. All RJE printer output will be processed on a printer 
and all RJE punch output will be processed on the IBM 2540 card read 
punch. 

During the test, supported partitions will operate in the normal way, 
processing job entries from the reader queue and placing output in the 
print and punch queues. 



ENDING THE TEST 

The RJE test may be ended at any time by typing the RJE option of the 
stop command for the RJE routine being tested. POWER/RJE will be 
restored for normal POWER and RJE operations. If an 

intervention-required condition exists at the IBM 2540 card reader, the 
reader must be readied by any card to complete termination of the test. 



Total Size of the POWER Partition 

To determine the size of the POWER partition, the assembly listing of 
the POWER-resident code may be useful. The listing contains the 
following labels valid for POWER without RJE: 

PBO Represents the size of the POWER-resident code. 

PROGEND Represents the size of the POWER-resident code plus all the 
program buffers specified. 

MAXSIZE MAXSIZE+120 is the POWER partition size necessary for your 
POWER. If less space is available in the POWER partition, 
fewer datablocks are allocated during POWER initiation. This 
means that successful operation cannot be guaranteed. 

MAXSIZE = PROGEND +DBLK+MAXBUFS 

INITEND INITEND+120 is the size cf the POWER program during its 

initiation. In case of small DBLK and MAXBUFS parameter values 
it can be greater than MAXSIZE. If it is greater than MAXSIZE, 
it determines the size of the POWER partition. For POWER RJE 
the storage required for RJBTMOD, RJBLKLST, and RJUSERS must be 
added. After successful POWER startup, the initiation code is 
overlaid by the program buffers and by the data buffers. 

To obtain equivalent values for RJE, refer to the linkage 
editor output of your POWER link- edit run. Calculate the 
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difference of the addresses given in hexadecimal for FGPSPOOL 
and LOCORE and add the result to the values above. The 
difference is the space necessary for the RJBTMCD, RJBLKLST and 
USERID list. 



Link-Editing POWER for a Supervisor without Relocating Loader 

For a supervisor without relocating loader, the assembled POWER deck has 
to be link-edited as follows: 

Remove the PHASE card from your object deck and prepare your own 
PHASE card with an absolute address. The absolute address must be the 
start address of the (real) POWER partition plus 120. 

Then link-edit your object deck as follows (this example is valid for 
POWERl as well as for POWER 2) : 

// JOB LINK POWER ABSOLUTE 
// OPTION CATAL 

PHASE POWERx,xxxx>cx 

=absolute address of the (real) POWER partition +120 

assembled object deck with original PHASE CARD REMOVED 

/* 

ENTRY INIT 
// EXEC LNKEDT 
/6 

Because the overlay phases of POWER are coded as self -relocatable, no 
changes are required for these. 



Start POWER 

With the following set of control statements, you iray start POWERl. The 
same statements are also valid for P0WER2 and FCWER3: 

I BATCH Fl command from console 
ASSGN,sysiN,X*OOC* assignment from console 
ASSGN SYSLST,X'OOE' 
// JOB INITIATE POWERl FROM CARD READER 
// ASSGN SYS001,X*161' FOR QFILE ON 3330 
// ASSGN SYS002,X«161' FOR DATAFIL ON 3330 
// DLBL QFILE, 'QFILE POWER' , 99/365, DA 
I // EXTENT SYS001,111111„1,0,19,2 (number of tracks =4 for P0WER3) 
// DLBL DATAFIL, 'DATAFIL POWER' , 99/365, DA 
// EXTENT SYS002,111111,1, 0,38,1900 
// EXEC POWERl, REAL 

For more detailed information, refer tc D OS/VS O peratin g Proc edures, 
GC33-5378. 

Note; If POWER is started with a procedure, dc not include the // EXEC 
statement for POWER in the procedure. Type it in separately. Otherwise 
the procedure library cannot be updated as long as POWER is active. 
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POWER Phases and Macros 

The names of the phases that make up the POWER program and that are 
delivered in the relocatable library, are listed in Figures 2-18 and 
2-19. The size of the resident POWER program is variable. The maximuir 
size of each overlay phase is 1024 bytes with the exception of phases 
FGPSPOLU, FGPSPOLV, FGPSPOLX, and FGPSPOLY, the maxiiruir size of which is 
2,018 bytes. 
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I Phase Name 

^ 

Resident POWER Prograir 

FGPSPOOL or user-name 

Overlay Phases 
FGPTYPNO 
FGPTYPNl 
FGPTYPSO 
FGPTYPDG 
FGPTYPDl 
FGPTYPD2 
FGPTYPRO 
FGPTYPLO 
FGPTYPLl 
FGPTYPPO 
FGPTYPAO 
FGPTYPAl 
FGPTYPA2 
FGPTYPJO 
FGPTYPZO 
FGPTYPZl 
FGPTYPZ3 
FGPTYPZ5 
FGPSPOLT 
FGPSPOLO 
FGPSPOLl 
FGPSP0L2 
FGPSPCL3 
FGPSPOLH 
FGPSP0L9 
FGPSPOLP 
FGPSP0L5 
FGPSP0L6 
FGPSP0L7 
FGPSP0L8 
FGPSPOLJ 
FGPSPOLY 
FGPSPOLZ 
FGPSPOLE 
FGPSPOLF 
FGPSPOLl 
FGPSPOLM 
FGPSPOLN 
FGPSPCLR 
FGPSPOLA 
FGPSPOLB 
FGPSPOLC 
FGPSPOLD 
FGPSPOLK 
FGPSPOLL 
FGPSPOLO 
FGPSPOLQ 
FGPSPOLU 
FGPSPOLV 
FGPSPOLW 
FGPSPOLX 
FGPSP0L4 
$$BP0WR1 



I Function 
4 



POWER supervisor execution processors 
POWER services 

Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Console command processor 
Local print writer routine 
Local print writer routine 
Local print writer routine 
Local print writer routine 
Local print writer routine 
Local print writer routine 
Local print writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Local punch writer routine 
Tape writer 
Tape writer 
Tape writer 
Tape writer 
Tape writer 
Reader routine 
Reader routine 
Reader routine 
Reader routine 
Reader routine 
Reader routine 
Print writer routine 
Print writer routine 
Punch writer routine 
3540 Reader routine 
3540 Reader routine 
3540 Reader routine 
3540 Reader routine 
Reader routine 
POWER initialize/terminate 



Figure 2-18. POWER Phases 
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+ ^ 



I Phase Name 

I- 

FGPTYPBO 

FGPTYPBl 

FGPTYPB2 

FGPTYPB3 

FGPTYPB4 

FGPTYPIO 

FGPTYPPl 

FGPTYPSl 

FGPTYPS2 

FGPTYPOO 

FGPPRJEB 

FGPPRJEC 

FGPPRJED 

FGPPRJEE 

FGPPRJEI 

FGPPRJEJ 

FGPPRJEM 

FGPPRJEO 

FGPPRJES 

FGTYPD5 

FGPPRJET 

FGPPRJEL 

FGPPRJEN 

FGPPRJEX 

FGPPRJEY 

FGPPRJEU 

FGPPRJEG 

FGPPRJEH 

FGPPRJEQ 

FGPPRJEF 

FGPPRJEU 

FGPPRJEV 

FGPPRJEW 

FGPPRJEZ 

FGPPRJEP 

IO27X0 

IO2540 



j Function 

4- 

I Console cowinand processor 
I Console command processor 
I Console command processor 
I Console command processor 
I Console command processor 
[Console command processor 
[Console command processor 
[Console command processor 
[Console command processor 
[Console command processor 
[Work station command processor 
(Work station command processor 
(Work station command processor 
[Work station command processor 
[Work station command processor 
(Work station command processor 
(Work station command processor 
[Work station command processor 
(RJE terminal reccnfigurator rci^tine 
[ Command processor 

(RJE work station command processor 
(RJE routine monitor 
(RJE routine reader 
[RJE routine reader 
(RJE routine reader 
(RJE routine reader 
(RJE routine punch writer 
(RJE routine punch writer 
[RJE routine punch writer 
( RJE punch writer routine 
(RJE routine print writer 
(RJE routine print writer 
(RJE routine print writer 
(RJE routine print writer 
(RJE message writer 
(RJE ETAM interface module 
(RJE local testing module 



L X J 



Figure 2-19. POWER RJE Phases 

Figure 2-19 shows the names and functions of the POWER RJE overlay 
phases. 

The POWER macros contained in the source statement library are: 

For local POWER: 

E.POWER 

E.POWERRES 

E.POWERSUP 

E.POWERBUF 

E.DSKIO 

For POWER RJE: 
E.RJEBLK 
E.RJEBLKLST 
E.RJBTMOD 
E.RJUSERS 
E.TPIO 
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The following system macros must also be available when POWER, with or 
without RJE, is assembled, including all BTAM iracrcs necessary tc 
assemble BTMOD and DTFBT: 



E.CCB 

E.EXCP 

E.ASYMCOM 

E.PE.DUMP 

E.EOJ 

E.LOAD 

E.WAIT 

S.SYSCOM 

E.BDYBOX 

E.MAPCCB 

E.MAPPIB 

E.MAPCOMR 

E.RONMODE 



E.OPEN 

E.DUMP 

E.LBRET 

DTFPH 

E.BTWAIT 

E. BTMOD 

E. DTFBT 



POWER Library Space Requirements 



POWER library space requirements are for: 

Core Image Library 92 Blocks 

Relocatable Library 531 Blocks 

Source Statement Library (Macros) 3,196 Blocks 



Deleting POWER Phases and Macros 

The statements to delete POWER phases and iracrcs are listed below, 
Source Statement Library 



// EXEC MAINT 

DELETS E.POWER 



DELETS E.TPIO 



/* 



For a complete list of the POWER macro names, refer to "POWER Phases 
and Macros". 



Relocatable Library 



// EXEC MAINT 
I DELETR FGPTYPNO 



DELETR IO25U0 



/* 
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For a complete list of the phase narres, refer to "POWER Phases and 
Macros". 



Core Image Library 



// EXEC MAINT 

DELETC FGPTYPNO 



DELETC IO2540 
/♦ 



For a complete list of the phase naires, refer to "POWER Phases and 
Macros". 
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Module 3: Installation Verification Procedure 
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Introduction 

DOS/VS provides Installaticn Verification Procedures tc enable you tc 
verify the generation of systeir coirponents. IVP verifies components 
such as the emulators, which are user-asseirbled , and systeir utilities, 
which are link-edited by the user. 

The IVP consists of a set of rracros (containing the verification 
procedures) which are distributed, along with the DCS/VS system, on the 
IBM-supplied distribution rriediurr,. Towards the end of system generation, 
after having deleted any unwanted DOS/VS system ccrrpcnents and having 

generated the components you require for verification, you should 
perform the insrallaticn verification procedure. 

The verification procedures are generated by assembling the IVPGEN 
macro. A number of parameters specify the optional SCP functions 
selected for verification, in addition to the standard functions which 
are included automatically. The standard functions are not included if 
you are running the program again to verify one cr mere functions cnly 
(indicated by the parameter RERUN-YES in the IVPGEN macro). 

For a complete description of the parameters cf the IVPGEN macro 
refer to the section entitled "IVPGEN Parameters". 



The Standard SCP Functions 



Z^BD - The ABEND Dump (part of program 57U5-SC-AIT) 

ASL - The assembler librarian Edit/De-Edit routines (part of the 

assembler program 5745-SC-ASM) 
UTL - The system utilities Disk-Only functions. Card, tape, and data 

cell functions are configuration dependent and optional (part of 

program 5745-SC-UTL) . 



The_QEtiqnal SCP Functions 



CAP - Cataloged procedures 

EMA - System/370 Emulator for JEM 1401/144 0/1460 
EMB - System/370 Emulator for JEM 1410/7010 
E20 - System/360 Model 20 Emulator 

OLT - OLTEP 
PWR - POWER 



IVP Books 



The separate parts that make up each verification procedure are 
contained in one or more pre-edited source stateirent library macro 
bookSe 



IVPGEN-Stage I — Assembly 

IVPGEN is a two-stage process. In stage I, the IVPGEN macro calls in 
the control books of the standard and selected SCP functions. The 
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/ 

generated jotstream (input f0r stage II) is SYSPCH output. You may 
assign SYSPCH to a card punch, a nagnetic tape unit, or a disk extent. 

If SYSPCH is assigned to a card punch, you irust remove the punched 
deck (output of stage I) fron the stacker and put it in a card reader as 
input to stage II (IVP execution) . The last card (an ct ject END card) 
of the deck ir-ust be removed. 

If SYSPCH is assigned to either tape or disk, there is an automatic 
transition from stage I to stage II provided that the required Job 
Control cards are punched (see Figure 3-1) . 

At the very beginning of system generation, ycu can assemble the 
IVPGEN macro with the option VERIFY=YES, under control of the 
IBM-supplied supervisor. This will provide you with a diagnostic cf the 
specified parameters. It also provides you (if specified in the IVPGEN 
assembly) with a job stream to delete the unused IVP bocks. 

This job can be run to free up space in the source statement library. 
The advantage of specifying VERIFY=YES is that you have ample time to 
correct any specification errors before the IVF procedure is actually 
performed at the end of system generation. 



IVPGEN- Stage II — Execution 

Before it actually starts executing the verification-, stage II 
successively performs 

• LISTIO ALL to display (on SYSLST) all the devices that are supported 

• MAP to display (on SYSLOG) the sizes of the partitions assigned 

• DSERV of all the assigned libraries to display in alphabetical order 
(on SYSLST) the names of all the transients, phases, modules, macros, 
and (optionally) procedures, that the system comprises. 
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IVPGEN PararTieters 

R. CorTip9nent Dependent 



„ ^ 

ABD= YES) I The ABEND dump IVP is always autcmatically 

I NO) [generated (YES is forced) unless RERUN=YES is 
specified in which case AEE=NO is the default 



ASL=fYESJ 

I no) 



The display, verify, replace, and delete 
capabilities of the ESERV prograir are 
autoiratically verified (YES is forced) unless 
RERUN=YES is specified, in which case the" 
default for ASL is NC. 



CAP=f no) 
(YES) 



Specify if Cataloged Procedures Support is to 
be verified. 



EMA=f no) 
(yes) 



Specify if the DOS/VS 1U01/1U40/1460 Emulator 
prograir is to be verified. i 



EMANAiyiE=name 



Specify the phase name of the user-generated 
1401/1440/1460 emulator program. 



EMATA=cuu 



Device address of the tape unit assigned to 
1400 tape unit 1. Specify only if tape 
functions are to be verified. 



EMATSN=SYSnnn 



Namie of the logical unit assigned to 1400 tape 
unit 1. Specify only if tape functions are to 
be verified. 



EMATYPE= 1401 

1401G, 
1440 ' 



Specify the type of verification procedure to 
be selected. Refer to the section entitled 
"EMA-1401/1440/146 Emulator" for a detailed 
description of the EMATYPE operands. 



EMB=( no) 
(YES) 



Specify if the DOS/VS 1410/7010 Emulator 
program: is to be verified. 



EMBNAME=name 



Specify the phase name of the user-generated 
1410/7010 emulator program. 



EMBTA=CUU 



Device address of the tape unit assigned to 
1400 tape unit 1, channel 1. Specify only if 
tape functions are to be verified. 



EMBTSN=SYSnnn 



Name of the logical unit assigned to 1400 tape 
unit 1, channel 1. Specify only if tape 
functions are to be verified. 



E20=( no) 
(YES) 



Specify if the System/360 Model 20 Emulator 
program generation is to- be verified. 



E20NAME=name 



Specify the phase name of the user-generated 
System/360 Model 20 Emulator program. 



OLT= j NO 
(YES 



Specify if the IVP job for OLTEP is to be 
generated. 
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A. Component Dependent (continued) 



PWR=) NO 

[yes 



Specify if the IVP job for POWER is to fce 
generated. 



UTL=JYES) 
NO) 



The disk functions of the systeir utilities are 
autoiratically verified (YES is forced) unless 
RERUN=YES is specified in which case the 
default for UTL is NO. 



UTLD^- (cuu,, cuu) 



Specify the disk device addresses of two work 
disks fcr use by the disk functions of the 
system utilities. 



UTLDRT=nnnn 



Disk extent relative track nuirber of a 
one-track work space on the disk work volumes 



UTLDT=J3330 
Innnn 



Specify the device type cf the two work disks, 



UTLDV= (nnnnnn,mmmmrara) 



Specify the volume serial numbers of the twc 
work disks in the same order as specified by 
the UTLDa parameter. 



UTLT= f NO j 
(YES) 



specify if the tape functions of the system 
utilities are to be verified. 



UTLTA=cuu 



Specify the device address of the tape drive on 
which a work tape is to be mounted. 



UTLTM= 



(col 

(mm) 



Specify the tape device mode. If this 
pararreter is oiritted, a 9-track, 1,600 BPI tape 
is assurried. 



UTLZ=( no) 
I YES) 



Specify if the data cell functions of the 
system utilities are to be verified. 



-^ 



UTLZA=cuu 



Specify the device address of the data cell 
drive that contains a work cell to be used by 
the Installation Verification Program. 



UTLZCN=n 



Specify the number of the work data cell, 



UTLZRT= 



Specify the data cell extent relative track 
number of a one-track work space on the data 
cell work volume. 
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Component I nde pendent 



DEmNSD= I YES I } Specify if a delete job is to be generated for j 



NO) 



those IVP books that are not used in this 
asseirbly of the IVPGEN macro. 



DELUSED=) NO 
I YES 



Specify if a delete job is to be generated for 
all the IVP books that are used in this 
assembly of the IVPGEN macro. 



IPTADDR=)OOC 
cuu 



Device address of the system card reader. 
SYSRDR and SYSIPT will be reset to this address 
after completion of IVP stage II. 



LSTADDR=100E 
cuu 



Device address of the system printer during 
the execution of IVP stage II. 



PCHADDR=cuu 



Device address of the system card punch during 
the execution of IVP stage II. If no 
verification of disk-to-card functions of the 
system utilities is desired, this parameter 
should not be specified. 



RERUN= NO 
YES 



Specify YES if this IVP is a rerun. A rerun 
can be performed if one or more SCP functions 
are to be verified again. If RERON=YES is 
specified, a default of NO is taken for ABD, 
ASL, and UTL. 



VERIFY=1 NO 
I YES 



Specification of YES causes a diagnostic to 
be made without generation of an IVP stage II 
job stream. In this case, the only job that is 
generated is the delete job for the unused IVP 
books (if DELUNSD=YES) . 
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t .^> 



IVP STAGE I INPUT — CREATION OF IVP STAGE II JOESTREAI^ 



In cards 

// JOB IVPSTGl 

LOG 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 



/* 



On ta^e 

// JOB IVPSTGl 

LOG 
// PAUSE "OPERATOR PLEASE MOUNT A SCRATCH TAPE ON UNIT X'cuu'" 

MTC REW,X'CUU' 
ASSGN SYSPCH, X'cuu' Assign SYSPCH to tape 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 

CLOSE SYSPCH, X'OOD' Close SYSPCH and reset tc standard assignment 
// PAUSE OPERATOR PLEASE MOUNT TAPE ON UNIT X'cuu' AGAIN 
ASSGN SYSIN, X'cuu' Set tc address of tape unit 
/S 



Stage 1 output 
(see Note) 
Stage 2 input 
(See Note) 



On disk 

// JOB IVPSTGl 

LOG L 

// DLBL IJSYSPH,'IVP STAGE II JOESTREAM ' 
// EXTENT SYSPCH, nnnnnn, ,,nnnn,nnnn 
// DLBL IJSYSIN,'IVP STAGE II JOESTREAM' 
// EXTENT SYSIN,nnnnnn, , ,nnnn,nnnn 
ASSGN SYSPCH, X'cuu' Assign SYSPCH to disk 
// OPTION DECK 
// EXEC ASSEMBLY 

IVPGEN selected parameters 

END 
/* 

CLOSE SYSPCH, X'OOD' Close SYSPCH and reset tc standard assignment 
ASSGN SYSIN, X'cuu" Set to disk address 
/£ 

Note; The extent information and volume sequence numbers in the two 
EXTENT statements must be identical. 



Figure 3-1. Example of IVP stage I Job Ccntrcl Statements 



PREPARING THE IVP JOESTREAM 

The following information should be carefully considered before you 
start executing the Installation Verification Procedures. 
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Set-Up Requiremeats 



SYSOOl, SYS002, SYS003, and SYSLNK must be assigned to disk work 

extents. 



If SYSPCH is assigned to a disk device, the allocated extent must 
bs at least 4 cylinders on a 2316 disk pack, 3 cylinders on a 3336 
disk pack, or 7 cylinders on a 3348 data module. 

A nninimuna of lUK bytes of real storage and cf 30K bytes of virtual 
storage must be allocated when executing IVP . If POWER is to be 
verified, add the storage requirements for POWER to these values. 



Operating Instructions 

Prepare the follo'^ing job control cards: 

1 

// JOB ASSEMBLE IVPGEN 

// PlSSGN SYSPCH, X'cuu' (can be card, tape, or a disk extent) 

// A.SSGN SYSOOl, X'cuu* work file 

// ASSGN SYS002,X'cuu' work file 

// ASSGN SYS003„X'cuu' work file 

// EXEC ASSEMBLY 

IVPGEN (selected parameters) 

END 
/* 
/£ 



If SYSPCH is assigned to a card punch, remove the last card from the 
deck. This is the (object) END statement, which cannot be processed 
by Job Control. Put the remaining cards in the hopper of the reader, 
assigned to SYSIN. Press START and EOF. IVP stage II will now be 
executed. 



If SYSPCH is assigned to either tape or disk close SYSPCH (if SYSPCH 
was assigned to tape, ready the tape device again) and assign SYSIN 
to the same tape or disk device. This will start the execution of 
IVP stage II. 

Sta^e II successively executes a: 

LISTIO ALL to display (on SYSLST) all the devices supported. 
MAP to display (on SYSLOG) the partition sizes assigned. 

DSERV DSPLYS ALL to provide a sorted printout of the library 
directories. 

Furthermore stage II performs the standard IVP functions that is 
verification of the ABEND duinp, of the Assembler and Utility Programs, 
and of all optional functions selected. It also produces the delete 
jobs for used and/or unused IVP books (if specified) . 
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ABD - The ABEND Dump 



The ABD function forces an abnormal end-of-job condition. A real 
storage dump is printed on SYSLST. 



ASL 



This IVP function verifies the display and update capabilities of the 
ESERV program. 

E xample _ _9f SYS LOG u tp u t 

BG // JOB IVPASL TEST ESERV 
DATE 11/04/73, CLOCK 07/22/56 

gQ * ******************************************************************** 

BG * IDENTIFICATION : HSFRV PROGRAM 

BG * PURPOSE : TO SHOW THE DISPLAY AND UPDATE CAPABI L IT I ES OF ESERV 

BG * FUNCTIONS TESTED : DISPLAY, VERIFY, REPLACE DELETE 

BG * SET UP REQUIREMENTS : SYS002, MUST BE ASSIGNED 

BG * TO DISK, SYSLST MUST BE ASSIGNED 

BG * NORMAL COMPLETION MESSAGES : * IVPASL COMPLETED ++++++++++++++++++++ 

BG * LISTING CONTAINS INSTRUCTIONS ON HOW TO 

BG * CHECK FOR SUCCESSFUL EXECUTION 

BG * MODULES TESTED/USED : IPKAD, IPKVA, IPKVD, IPKVE, IPKVF, 

BG * IPKVG, IPKVI, IPKVK, IPKVM 

BG * INPUT DESCRIPTION : TWO DSPL^ CONTROL CARDS, THE SECOND 

BG * FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

BG * AND ) END CARDS, AN EDITED MACRO 

BG * C IVPAS' S ) IN THE E SUBLIBRARY 

BG * OUTPUT DESCRIPTION : A DISPLAY OF IVPASLS; A DISPLAY OF IVPASLS, 

BG * UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

QQ * ******************************************************************** 

BG * IVPASL COMPLETED ++++++++++++++++++++++++ 
BG EOJ IVPASL 

DATE lT/0'+/73, CLOCK 07/24/59, DURATION 00/02/02 
BG 1C00A ATTN. OC. 
BG 
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Example of SYSLST Output 

// JOB IVPASL TEST ESERV DATE 11 / 04/ 7 3 tCLOCK 07/22/56 

* IDENTIFICATION: ESERV PROGRAM 

* PURPOSE: TO SHOW THE DISPLAY AND UPDATE CAPABILITYS OP ESERV 

* FUNCTIONS TESTED: DISPLAY, VERIFY, REPLACE, DELETE 

* SET UP REQUIREMENTS: SYSOOl, SYS002 MUST BE ASSIGNED 

* TO DISK, SYSLST MUST BE ASSIGNED 

* NORMAL COMPLETION MESSAGES: * IVPASL COMPLETED ++++++++++++++++++++ 

* LISTING CONTAINS INSTRUCTIONS ON HOW TO 

* CHECK POR SUCCESSFUL EXECUTION 

* MODULES TESTED/USED: I PKAD , I PKVA ,1 PKVD , I PKVE, T PKVF, 

* IPKVG.IPKVI ,IPKVK,IPKVM 

* INPUT DESCRIPTION: TWO DSPLY CONTROL CARDS, THE SECOND 

* FOLLOWED BY ) COL, ) VER, ) REP, ) DEL 

* AND ) END CARDS, AN EDITED MACRO 

* (IVPASLS) IN THE E SUBLIBRARY 

* OUTPUT DESCRIPTION: A DISPLAY OF IVPASLS, A DISPLAY OP IVPASLS, 

* UPDATED BY THE ) REP CARDS, AN UPDATE SURVEY 

// EXEC ESERV 



DSPLY E IVPASLS 



E. IVPASLS 73/11/04 

CATALS A. IVPASLS 

1 MACRO 00000000 

2 IVPASLS SPPl ,£PP2,SPP3,£PP4,&PP5,SPP6, X 

3 &KW1=,£KW2=,SKW3= 

4 * DISK OPERATING SYSTEM no2?noon 

5 * IVPASLS - 57^5-SC-ASM - RELEASE 28^0 0030noOO 

6 * /* START OF SPECIFICATIONS ****5!=************:jt*:?cJt:{e:>c*****:}c>!ci!csjc* 00310000 

7 * 00320000 

8 *01* MODULE-NAME = IVPASLS 00330000 

9 * 003^0000 

10 *01* DESCRIPTIVE NAME = INSTALLATION VERIFICATION PROCEDURE 003^-2 000 

11 * TEST PROGRAM* POR ESERV PROGRAM 003^^5^000 

12 * -SOURCE BOOK- 003^^6000 

13 * 003^-- 8 000 
1^ *01,* FUNCTION = AS FOLLOWS. 003481 00 

15 * THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 00343200 

16 ^ INSTALLATION VERIFICATION PROCEDURE (IVP). TO CHECK THAT 00348600 

17 * THE IVP WAS SUCCESSFUL, COMPARE THE TWO DISPLAYS 0^ THIS 00349000 

18 * MACRO THE IVP P^.INTSc THEY OUGHT tq BP EQUAL, EXCEPT 003^^100 
1° * FOR TWO STATEMENTS. THE STATEMENT NUMBER 007500 00349200 

20 ^ AIF (T'{1PP2 EQ 'OM.TWO no35O900 

21 * IN THE FIRST DISPLAY WILL BE CHANGED TO - 00352900 

22 * AIF (T'aPP2 EQ 'OM. THREE 00355000 

23 * IN THE SECOND DISPLAY. THE STATEMENT NUMBER 014000 00356800 

24 * MNOTE ' VALUE OF ££PP5 IS SPP6' 00357200 

25 * IN THE FIRST DISPLAY WILL BE DELETED IN THE SECOND DISPLAY 0O357600 

26 * 00360900 

27 *01* NOTES = CHANGE ACTIVITY O0361 500 

28 * a DENOTES CHANGE ACTIVITY FLAGS. D IS SYSTEM IDENTIFIER 00361900 
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2^ * 

30 * 

31 * 

32 * 

33 *01* 
3A * 

35 * 

36 * 

37 * /* 

38 GBLA 



GBLB 
GBLC 
LCLA 
LCLB 
LCLC 
ONF 



39 
40 
Al 
42 

43 
44 

45 

46 SGBLA 

47 eTWn 
48 

49 CGBLB 

50 .THRF 
51 

52 EGBLC 



FOR DOS. MFANING OF THE THIRD CHARACTER IS: A = APAR, 
M = PTM, L = NEW DEVELOPMENT. ALL OTHER CHARACTERS ARE 
FOR IBM INTERNAL USEc 

CHANGE ACTIVITY = AS FOLLOWS. 

CHANGE DESCRIPTIONSc 

NEW MODULE - FIRST RELEASE 28. 

END OF SPECIFICATIONS ********:!:************************** 
SGBLA 
&GBLB 
&GBLC 
SLCLA 
SLCLB 
&LCLC 

ANOP 

AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SFTC 



aOL 28301 



(T'aPPl EQ '0' )cTWO 
&PP1 

(T'&PP2 EQ '0' )cTWO 
(1) 

(T'?;PP3 EQ '0' )cFOUR 
' &PP3' 



0036^000 
00366100 
00368200 
00370300 
00372400 
00374500 
003766^0 
00378600 
00380600 



00650000 
00700000 

00750000 
00800000 

00850000 
00900 000 



Ec IVPASLS 



73/1 1/04 



53 .FOUR 
54 

55 SLCLA 

56 .FIVE 
57 

58 SLCLB 

59 .SIX 
60 

61 SLCLC 

62 .SEVEN 
63 

64 
65 
66 
67 
68 
69 
70 
77 
72 
73 
7Z^ 
75 
76 
77 



EIGHT 



NINE 



TEN 



ELEVEN 



ANOP 

AIF 

SETA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

AIF 

MNOTE 

MNOTE 

ANOP 

AIF 

MNOTE 

ANOP 

MNOTE 

MEND 



(T'SKWl EQ 'OM.FIVF 
&KW1 

T'£KW2 EQ '0' )oSIX 
1) 

T'£KW3 EQ '0' )cSEVFN 
&KW3' 

T'£PP4 EQ '0' )c EIGHT 

VALUE OF ££PP4 IS SPP4« 

T'£PP5 EQ »0' ).NINF 

VALUE OF &SPP5 IS SPP5' 



00950000 
OlOOOOOO 

01050000 
01100000 

01150000 
01200000 

012 50000 
01300000 

013 50000 
01360 000 



T'£PP6 EQ 'OM.TEN 0137O000 

VALUE OF 8,SPP5 IS eiPP6' THIS STATEMENT WILL BE DELETED 01400000 
VALUE OF £&PP6 IS SPP6' 01450000 



NOT SGBLB AND NOT E LCLB) . EL EVEN 
VALUE OF &&PP2+&&KW2 IS &PP2+8KW2' 

' &EPP2 AND/OR 8,&KW2 NOT SPECIFIED' 



01500000 
01550000 

01600000 
01750000 
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nSPLY f, IVPASLS 



E.IVPASLS 



73/1 l/O^t 



1 
2 
? 
6. 

5 
6 
7 
8 
9 

m 
11 

12 
13 
14 

15 
16 
17 
18 
19 
?n 

21 
22 
23 
2A 
2 5 
26 
27 

28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
4° 
50 
51 
52 



CATALS A. IVPASLS 
MACRO 
IVPASLS £PP1 ,&PP2,&PP3,£PP4,£PP5,?IPP6» 
&KW1 = ,?1KW2 = ,£KW3 = 

* niSK OPERATING SYSTEM 

* IVPASLS - 5745-SC-ASM - RELEASE 28 

* /* START OF SPECIFICATIONS ********************************* 
* 

*01* 
* 

*01* 
* 



MODULE-NAME = IVPASLS 



DESCRIPTIVE NAME = 



INSTALLATION 
TEST PROGRAM 
-SOURCE BOOK- 



VERIFICATION PROCEDURE 
FOR ESERV PROGRAM 



* 

*oi* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

*01* 

* 

* 

* 

* 

*oi* 

* 

* 

* 

* /* 

GBLA 
GBLB 
GBLC 
LCLA 
LCLB 
LCLC 
c ONE 

EIGBLA 
.TWO 



&GBLB 
.THREE 

SGBLC 



FUNCTION = AS FOLLOWS. 

THIS MACRO IS USED AS INPUT TO THE ESERV PROGRAM IN THE 
INSTALLATION VERIFICATION PROCEDURE (IVP). TO CHECK THAT 
THF IVP WAS SUCCFSSFULi COMPARE TH'= TWO DISPLAYS OF THIS 
MACRO THE IVP PRINTSc THEY OUGHT TO BE EQUAL, EXCEPT 
FOR TWO STATEMENTS. THE STATEMENT NUMBER 007500 

AIF (T'?IPP2 EQ '0' ).TWO 

IN THF FIRST DISPLAY WILL BE CHANGED TO - 

AIF (T»&PP2 EQ '0' ). THREE 

IN THF SECOND DISPLAY. THE STATEMENT NUMBER 014000 

MNOTE ' VALUE OF &£PP5 IS &PP6' 
IN THE FIRST DISPLAY WILL BE DELETED IN THE SECOND DISPLAY 



NOTES = CHANGE ACTIVITY 

a DENOTES CHANGE ACTIVITY 

FOR DOS. MEANING 

M = PTM, L = NEW DEVELOPMENT. 

FOR IBM INTERNAL USEc 



FLAGS, n IS SYSTEM IDENTIFIER 
OF THE THIRD CHARACTER IS: A = APAR, 
ALL OTHER CHARACTERS ARE 



CHANGE ACTIVITY = AS FOLLOWS 

CHANGE DESCRIPTIONSc 

NEW MODULE - FIRST RELEASE 



28 



END OF SPECIFICATIONS *********************************** 
SGBLA 
&GBLB 
SGBLC 
&LCLA 
SLCLB 
eiLCLC 
A NOP 



3DL28301 



AIF 

SFTA 

ANOP 

AIF 

SETB 

ANOP 

AIF 

SETC 



(T«&PP1 
&PP1 

(T«&PP2 
(1) 

(T'£PP3 
'£PP3' 



EQ '0' ).TWO 



EQ '0' )cTHREE 



EQ 'OMcEOUR 



00000000 



002 50000 

003 00000 
O031OO00 
00320000 
0033O000 
00340000 
00342000 
00344000 
00346000 
00348 000 
O0348100 
00348200 
003^8600 
00349000 
00349100 
00349200 
00350900 
00352 900 
00355000 
00356800 
0035"7200 
003 5 "'600 
00360900 
00361500 
00361900 
00364000 
00366100 
00368200 
003^0300 
00372400 
00374500 
00376600 
003786O0 
00380600 



00650000 
00700000 



00800000 

00850000 
0090O0O0 
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EoIVPASLS 












53 


.FOUR 


ANOP 








5A 




AIF 


T'&KWl 


EQ 


•OM.FIVF 


55 


SLCLA 


SETA ! 


:kwi 






56 


.FIVF 


ANOP 








57 




AIF ( 


T'&KW2 


EQ 


'0' )oSIX 


58 


SLCLB 


SFTB 


[1) 






59 


.SIX 


ANOP 








60 




AIF ( 


T'&KW3 


EQ 


•0' )cSEVFN 


61 


SLCLC 


SETC 


•SKW3' 






62 


.SFVFN 


ANOP 








6? 




AIF 1 


T'&PPA 


EQ 


•0' )c EIGHT 


64 




MNOTE 


' VALUE 


OF 


&&PP4 IS SPP4' 


65 


.FIGHT 


ANOP 








66 




AIF 


T'&PP5 


EQ 


•0« ).NINE 


67 




MNOTE 


' VALUE 


OF 


££PP5 IS £PP5' 


68 


. NI NF 


ANOP 








69 




AIF 


[T'&PP6 


EQ 


'0' ).TEN 


70 




MNOTE 


■ VALUE 


OF 


££PP6 IS &PP6' 


71 


.TEN 


ANOP 








72 




AIF 


(NOT SGBLB 


AND NOT SLCLB). ELEVEN 


73 




MNOTE 


• VALUE 


OF 


££PP2+S&KW2 IS £PP2+£KW2 


74 


.FLFVEN 


ANOP 








75 




MNOTE 


' &SPP2 


AND/OR &£KW2 NOT SPECIFIED' 


76 




MFND 









73/1 1/04 



00950000 
01000000 

01050 000 
01100000 

01150000 
01200000 

012 50000 
01300000 

01350000 
01360000 

01370000 
01450000 

01500000 
01550000 

01600000 
01750000 



E.IVPASLS 




UPDATE SURVEY 




) COL 


73,6 




) VFR 


O03O0O 




* IVPASLS - 57A5-SC-ASM 


- RELEASE 28oO 


* IVPASLS - 5745-SC-ASM 


- RELEASE 28c0 


) VER 


007000+1,8 




.TWO 






.TWO 


ANOP 




) RFP 


00750O 






AIF (T'£;PP2 FQ 


'0M= TWO 




AIF (T'SPP? EQ 


•OMcTHREE 


) DEL 


014000 






MNOTE • VALUE OF 


S&PP5 IS £PP6« THIS STATEMENT 


) FNP 




WILL BE DELETED 



00300000 



00750000 



01400000 



73/1 1/04 



....VERIFY CARD 
cccc ACTUAL STMT 

oooo VERIFY CARD 
coo e ACTUAL STMT 

ooocDELETFO 
oooc ADDED 

ooocDELETED 



END OP UPDATE SURVEY 



/* 



THIS TERMINATES THE ESERV PROCESSING 



* IVPASL COMPLETFD ++++++++++++++ 
EOJ IVPASL 



DATE n/04/73, CLOCK 07/24/50, DURATI ON 00/02/02 



STOP 
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CAP - Cataloged Procedures 



This function verifies the cataloging of a procedure into the procedure 
library and its subsequent execution. 



Set-Up Requirements 

A procedCire library must be allocated. More than six unused blocks must 
be available in the ireirber space. 

Ex ample o f S YS LOG, O utp ut 

BG // JOB IVPCAPl 

DATE 1.1/04/73. CLOCK 07/14/36 

QQ * ************************************************************* 

BG *"^ IDENTIFICATION : IVPCAPl 

BG * PURPOSE : CATALOGING OF A PROCEDURE 

BG * FACTIONS TESTED : CATALP 

BG * SET UP REQUIREMENTS : SYSTEM WITH PROCEDURE 

BG * LIBRARY WITH MORE THEN SIX UNUSED BLOCKS IN MEMBER SPACE 

BG * MODULES TESTED : MAINT 

BG * OUTPUT DESCRIPTION : SYSTEM STATUS REPORT PRODUCED 

BG * BY $MAINEJ0 

BG * ************************************************************** 

BG EOJ IVPCAPl 

DATE 11/0V73, CLOCK 07/16/20, DURATION 00/01/43 
BG // JOB IVPCAP2 

DATE 11/04/73, CLOCK 07/16/28 

QQ * *************************************************************** 

BG * IDENTIFICATION : IVPCAP2 

BG * PURPOSE : EXECUTION OF A CATALOGUED PROCEDURE 

BG * FUNCTIONS TESTED j. EXECUTION OF CATALOGUED PROCEDURE IVPCAPl 

BG * WHEREBY AN ASSEMBLED PROGRAM IS ASSEMBLED, 

BG * LINK EDITED, TEMPORARIL CATALOGUED INTO 

BG * 'THE CORE IMAGE LIBRARY AND EXECUTED 

BG * SET UP REQUIREMENTS : SYSLNK, SYS001, SYS002, SYS003 MUST BE 

BG * ASSIGNED 

BG * MODULES TESTED : JOB CONTROL 

BG * OUTPUT DESCRIPTION : PRINTING OF DATA LIST 

BQ * **************************************************************** 

BG * BEGIN OF PROCEDURE 

BG * END OF PROCEDURE 

BG EOP IVPCAPl 

BG IVPCAPl STARTED ++++++++++++++++++++++ 

BG IVfiCAPI COMPLETED SUCCESSFULLY +++++++++++++++++++++++ 

BG EOJ IVPCAP2 

DATE 11/04/73, CLOCK 07/20/29, DURATION 00/03/59 

DATE 11/04/73, CLOCK 07/20/36 
BG * DELETE IVPCAPl FROM PROCEDURE LIBRARY 
BG EOJ IVPCAP3 

DATE 11/04/73, CLOCK 07/21/17, DURATION 00/00/41 
BG ICOOA ATTN. OC. 
BG 
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Example of SYS LST O utpu t 



// JOB IVPCAPl 

* IDENTIFICATION: IVPCAPl 

* PURPOSE: CATALOGING OF A PROCEDURE 

* FUNCTIONS TESTED: CATALP 

* SET UP REQUIREMENTS: SYSTEM WITH PROCEDURE 

* LIBRARY WITH MORE THEN SIX UNUSED BLXKS IN MEMBER SPACE 

* MODULES TESTED: MAI NT 

* OUTPUT DESCRIPTION: SYSTEM STATUS REPORT PRODUCED 

* BY /MAINEJO 

// EXEC MAINT 



DATE 11 /04/73, CLOCK 07/14/36 



CATALP IVPCAPl 



PRIVATE DIRECTORY 
11/04/73 



DIRECTORY STARTING ADDRESS 
DIRECTORY NEXT ENTRY 
DIRECTORY LAST ENTRY 

LIBRARY STARTING ADDRESS 
LIBRARY NEXT AVAILABLE ENTRY 
LIBRARY LAST AVAILABLE ENTRY 



DIRECTORY ENTRIES ACTIVE 

LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 

LIBRARY BLOCKS DELETED 

LIBRARY BLOCKS AVAILABLE 

AUTOMATIC CONDENSE LIMIT 

LIBRARY ALLOCATED CYLINDERS 
DIRECTORY ALLOCATED TRACKS 



PRV-CORE 


IMAGE 


PRV-RELOCATABLE 
_ncrTMAi ______ 


PRV-SOURCE STATEMENT 


C 


H 


R 


E 


-— — — — — UCU inAL~"~~~~ — 

C H R E 


C 


H 


R E 


47 


10 


01 




73 


00 01 


103 


00 


01 


47 


12 


06 


08 


73 


02 09 16 


103 


01 


15 07 


47 


14 


15 


17 


73 


09 17 19 


103 


09 


27 09 


47 


15 


01 




73 


10 01 


103 


10 


01 


71 


07 


02 




98 


10 12 


196 


05 


02 


72 


19 


04 




102 

.__QT ATI IC 


19 16 

TMCnCMAT TDM—. 


196 


19 


27 


637 








~~o 1 A 1 UO 

849 


lINrUKnAI lUN 


412 






2020 








9440 




50490 






1861 








7922 




50086 






28 








89 




00 






131 








1429 




404 






00 








00 




00 






26 








30 




94 






05 








10 




10 
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SYSTEM DIRECTORY— SYSRES 
11 /Oi^m 



DIRECTORY STARTING ADDRESS 
DIRECTORY NEXT ENTRY 
DIRECTORY LAST ENTRY 

LIBRARY STARTING ADDRESS 
LIBRARY NEXT AVAILABLE ENTRY 
LIBRARY LAST AVAILABLE ENTRY 



DIRECTORY ENTRIES ACTIVE 



LIBRARY 
LIBRARY 
LIBRARY 
LIBRARY 



BLOCKS ALLOCATED 
BLOCKS ACTIVE 
BLOCKS DELETED 
BLOCKS AVAILABLE 



AUTOMATIC CONDENSE LIMIT 



LIBRARY ALLOCATED CYLINDERS 
DIRECTORY ALLOCATED TRACKS 



CORE- 


-IMAGE 


RELOCATABLE 

_^__^^__nP'~ TU Al 


SOURCE-STATEMENT 


PROCEDURE 


C 


H 


R 


E 


C 


. k* X 1-1 Ml- - 

H R 


E 


C 


H 


R 


E 


C 


H 


R E 


CO 


10 


01 




16 


00 01 




31 


00 


01 




41 


00 


01 


00 


11 


15 


16 


16 


01 07 


02 


31 


00 


08 


03 


41 


00 


03 06 


00 


14 


15 


17 


16 


04 17 


19 


31 


04 


27 


09 


41 


04 


27 09 


00 


15 


01 




16 


05 01 




31 


05 


01 




41 


05 


01 


14 


00 


02 




27 


04 05 




38 


14 


05 




41 


09 


36 


15 


19 


04 




30 

»C T ATI 1 C 


19 16 

TMCnD^ 




40 


19 


27 




45 


19 


40 


538 








b 1 Al Uo 

457 


INrUKhHi ixjxH — 


68 








20 






1220 








4720 






5265 








3795 






1061 








3508 






4027 








133 






00 








00 






00 








07 






159 








1212 






1238 








3605 






65535 








00 






65535 








00 






15 








15 






10 








05 






05 








05 






05 








05 







// EXEC PSERV 



IVPCAPl VERSION OoO 7 

* BEGIN OF PROCEDURE 
// OPTION LINK 

// EXEC ASSEMBLY 

ENTRY 
// EXEC LNKEDT 

* END OF PROCEDURE 
/+ 



BLOCKS 



PROCEDURE LIBRARY 



EOJ IVPCAPl 



DATE :i1/04/73, CLOCK 07/16/20,DURATI ON 00/01/43 
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// JOB IVPCAP2 

* IDENTIFICATION: IVPCAP2 

* PURPOSE: EXECUTION OF A CATALOGUED PROCEDURE 

* FUNCTIONS TESTED: EXECUTION OF CATALOGUED PROCEDURE IVPCAPl 

* WHEREBY AN ASSEMBLER PROGRAM IS ASSEMBLED, 

* LINK EDITED, TEMPORARILY CATALOGUED INTO 

* THE CORE IMAGE LIBRARY AND EXECUTED 

* SET UP REQUIREMENTS: SYSLNK,SYS001 ,SYS002,SYS003 MUST BE 

* ASSIGNED 

* MODULES TESTED: JOB CONTROL 

* OUTPUT DESCRIPTION: PRINTING OF DATA LIST 

// EXEC PR0C=IVPCAP1 

* BEGIN OF PROCEDURE 
// OPTION LINK 

// EXEC ASSEMBLY 



DATE 11 /04/73, CLOCK 07/16/28 



EXTERNAL SYMBOL DICTIONARY 



PAGE 



SYMBOL 



TYPE 



ID ADDR LENGTH LD-ID 



TEST 

IJDFZZZZ 

IJDFZZZZ 



SO (CSECT) 
ER (EXTRNJ 
SD (CSECT) 



IJCFZIZO ER (EXTRN) 



01 007D00 0001 Co 

02 

03 000000 00002A 

04 



DUMMY SECTION DICTIONARY 



SYMBOL ID LENGTH 

IJDPD012 FF 00C030 
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PAGE 



LOC OBJECT CODE 
007000 



ADDRl ADDR2 STMT SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 28.0 07.19 73/11/01* 



007000 05A0 

007D02 41BG A0D8 

007006 181B 
007008 OAOO 

00700A 181B 
00700C 9180 1002 
007010 4710 A014 
007014 0A07 

007D16 0700 

007018 

007018 4110 A1A6 

00701C 4500 A026 

007020 00007DA8 

007024 00007078 

00702 8 0A02 



07002 
07DDA 



00002 
07016 



07EA8 
0702 8 



START 32000 
IVPCAPS 
IVPCAPS - 5754-SC-LBR 



/* START OF SPECIFICATIONS ****************************************** 

M0OULE-NAME=IVPCAPS 

OESCRIPTIVE-NAME=INSTALLATION VERIFICATION PROCEDURE 
TEST FOR CATALOGUED PROCEDURES 



1 TEST 

2 

3+* 

4+* 

5+* 

6+* 

7+*01* 

8+* 

9+*01* 
10+* 
11+* 
12+*01* 
13+* 
14+* 
15+* 
16+* 
17+*01* 
18+* 
19+* 
20+* 
21+* 
22+**** 
23+START 
24+ 
2 5+ 
26+* 
27+ 
28+ 
29+* 
30+ 
31+ 
32+ 
33+ 

34+* IOCS - 
35+ 
36+ 
37+ 

38+IJJ00004 
39+ 
40+ 
41+ 



RELEASE 28.0 



NOTES = CHANGE ACTIVITY 

a DENOTES CHANGE ACTIVITY FLAG. 



IS SYSTEM IDENTIFIER FOR DOS. 



MEANING OF THE THIRD CHARACTER IS - A=APAR t M=PTM,I =NEW 
DEVELOPMENT. OTHER CHARACTERS ARE FOR IBM INTERNAL USEo 

CHANGE ACTIVITY = AS FOLLOWS 
CHANGE DESCRIPTIONS 
NEW MODULE - FIRST RELEASE 28 
WRONG SEARCH IN PCIL 



END 



LA 
SUPVR COMMN 

LR 

SVC 
SUPERVISOR 

LR 



OF SPECIFICATIONS *******************************************/ 
BALR 10,0 
USING *,10 

REG.TYPECCB 
MACOS - EXCP - 5745-SC-SUP - REL. 28.0 

I.REG 

EM 

WAIT - 5745-SC-SUP - REL. 28.0 

1,REG 



TM 2(1),X'80' 

BO *+6 

SVC 7 

OPEN - 5745-SC-IOX - REL 28.0 
CNOP 0,4 
DC OF'O' 
LA l,=C'/fBOPEN • 
BAL 0,*+4+4*(3-l> 
DC A(INPUT) 
DC A (OUT PUT) 
SVC 2 



04000028 
05000028 
06000028 
07000028 
08000028 
09000028 
10000028 
11000028 
12000028 
13000028 
14000028 
15000028 
16000028 
17000028 
18000028 
19000028 
20000028 
21000028 
22000028 
23000028 
24000028 
25000028 
26000028 
15050028 
50000025 
55010028 
12000028 
39000025 
54000025 
570P0025 
60000025 
12000028 
20000025 
22000025 
46000025 
54000025 
64000025 
64000025 
74000025 



43+* IOCS - GET - 5745-SC-IOX - REL 28o0 



007D2A 5810 A1B6 
007D2E 58F1 0010 
007D32 45EF C008 

007036 5810 AlBA 
007D3A 58F1 0010 
007D3E 45EF OOOC 



07EB8 
00010 
00008 

07EBC 
00010 
OOOOC 



44+LABEL 

45+ 

46+ 



L 
L 

BAL 



1,=A(INPUT) 

15,16(H 

14,8(15> 



GET DTF TABLE ADDRESS 
GET LOGIC MODULE ADDRESS 
BRANCH TO GET ROUTINE 



47+* IOCS AND DEVICE INDEPENDENT I/O - PUT - 5745-SC-IOX - REL. 28.0 



48+ 
49+ 
50+ 



L 

L 
BAL 



1,=A(0UTPUT) 

15,16(1) 

14,12(15) 



GET DTF TABLE ADDRESS 
GET LOGIC MODULE ADDRESS 
BRANCH TO PUT ROUTINE 



12000028 
42000025 
75000025 
78000025 
05000028 
15000025 
3-5 54000025 
3-5 55000025 
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PAGE 



LOC OBJECT CODE 

007D42 47F0 A028 

0C7D46 0700 
007D48 

007D48 4110 AlAE 
007D4C 4500 A056 
007D50 00007DA8 
007D54 00007D78 
00705 8 OA02 
007D5A 41B0 A0F6 
007D5E 50B0 AOEO 



ADDRl ADDR2 STMT SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 28.0 07.19 73/11/0'+ 



07D2A 





*** ERROR *** 


007D62 


41B0 A0D8 


007066 


181B 


007068 


OAOO 


007D6A 


181B 


007D6C 


9180 1002 00002 


007D70 


4710 A074 07D76 


007074 


0A07 


007076 


OAOE 


007D78 




007078 


00008C000000 


00707E 


00 


00707F 


03 


007080 


00007DA0 


007084 


00000000 


007D88 


00 


007089 


000000 


00708C 


08 


007080 


10 


0070 8E 


09 


007D8F 


09 


007090 


00007E58 


007094 


00000000 


007D98 


0700 


007D9A 


4700 0000 00000 


007D9E 


0000 


007DA0 


09007E5820000050 


000000 




000000 




000002 




000003 




000004 





07EB0 
07D58 



07DF8 
07DE2 



07DDA 



07DA8 



51+ 

52+* IOCS 

53+ 

54+END 

55+ 

56+IJJC0007 

57+ 

58+ 

59+ 

60+ 

61+ 



B LABEL 

AND DEVICE INDEPENDANT I/O 
CNOP 0.4 



CLOSE - 5745-SC-IOX - REL. 28.0 



DC OF'O" 

LA 1,»C'//BCL0SE' 
BAL 0,*+4+4*(3-l) 

DC A(INPUT) 

DC A (OUT PUT) 

SVC 2 

LA REG.TYPNCCW 

ST REG,TYPECCB+8 



62+ LA REG.TYPECCB 

A3+* SUPVR COMMN MACOS ^ EXCP 

64+ LR 

65+ SVC 

66+* SUPERVISOR 

67+ LR 

68+ TM 

69+ BO 

70+ SVC 

71+* SUPVR COMMN MACROS 

72+ SVC 14 



57''i5-SC-SUP - REL. 2S. 
I.REG 


WAIT - 5745-SC-SUP - RELo 28oQ 
I.REG 
2(1),X«80' 
*+6 
7 

EOJ - 5745-SC-SUP - REL. 28.0 



33000028 
08100028 
20000025 
22000025 
46000025 
54000025 
64000025 
64000025 
74000025 
35000028 
36000028 

36050028 
15050028 
50000025 
EM 55010028 
12000028 
39000025 
54000025 
57000025 
60000025 
40000028 
50000025 



74+* IOCS AND DEVICE INDEPENDANT I/O 


75+ 


DC 


OD'O' 


76+ OUT PUT 


DC 


X'000080000000' 


77+ 


DC 


ALKO) 


78+ 


DC 


AL1(3) 


79+ 


DC 


A(*+32) 


80+ 


DC 


4X'00' 


81+ 


DC 


ALKO) 


82+ 


DC 


VL3(IJDFZZZZ) 


83+ 


DC 


X«08« 


84+ 


DC 


AL1(16) 


85+ 


DC 


AL1(9) 


86+ 


DC 


AL1(9) 


87+ 


DC 


A(IN+0) 


88+ 


DC 


4X'00' 


89+ 


NOPR 





90+ 


NOP 





91+ 


DC 


2X'00« 


92+ 


CCW 


9,IN+0,X'20',80-0 


93+IJJZOOll 


EQU * 


94+* IOCS AND DEVICE INDEPENDANT I/O 


95+IJDPD012 


DSECT 


96+IJDP0012 


DS 


CL2 


97+IJDP1012 


OS 


CLl 


98+IJ0P2012 


DS 


CLl 


99+IJDP0012 


DS 


CL2 



OTFPR - 5745-SC-IOX - REL. 28.0 



JJ 



RES. COUNT, COM. BYTES BTS 
LOGICAL UNIT CLASS 
LOGICAL UNIT 

CCW ADDR. JJ 

CCB-ST BYTE.CSW CCW ADDRESS JJ 

SWITCH 3 4-0 

ADOR OF LOGIC M0DUL3-8 



(PRINTER) 



JJ 



DTF TYPE 
SWITCHES 

NORMAL COMMo CODE 

CONTROL COMM. CODE 
ADDRESS OF DATA IN lOAREAl 

B UC KE T 

PUT LENGTH IN REG12 (ONLY UNOEF. 
LOAD USER POINTER REG 

NOT USED 



4-0 
4-0 



3-5 



3-5 

4-0 



- PRMOD - 5745-SC-IOX - RELo 28.0 

RESIDUAL COUNT 
COMMUNICATION BYTE 1 
COMMUNICATION BYTE 2 
CSW STATUS BYTES 



02870028 
60000025 
61510028 
70000025 
70200028 
71000028 
71200028 
71750027 
76800025 
77580028 
77600025 
78000027 
78400027 
78800025 
84000025 
84800025 
86400025 
89600025 
91200027 
92000025 
01290028 
16200025 
16400025 
16600025 
16800025 
17000025 
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PAGE 



LOC 


OBJECT CODE 


ADDRl 


ADDR2 


STMT SOURCE 


STAT EM 


ENT 


000006 








100+IJDP3012 


OS 


CL2 


000008 








101+ 


OS 


CLl 


000009 








102+IJDP4012 


OS 


CL3 


OOOOOC 








103* 


DS 


CLl 


OOOOOD 








104+ 


DS 


CL3 


000010 








105+IJDM1012 


OS 


CL4 


000014 








106+IJDP5012 


DS 


CLl 


000015 








107+IJDP6012 


DS 


CLl 


000016 








108+IJDP9012 


DS 


CLl 


000017 








109+IJDPA012 


DS 


CLl 


000018 








110+IJDP7012 


DS 


CL4 


OOOOIC 








111+1JDP8012 


OS 


CL4 


000020 








112+IJDPB012 


DS 


CL2 


000022 








113+1JDPC012 


DS 


CL4 


000026 








114+IJDPE012 


DS 


CLl 


000027 








115+IJDPF012 


DS 


CLl 


000028 








116+IJDPG012 


DS 


CLl 


000029 








117+IJDPH012 


DS 


CL3 


00002C 








118+IJDPI012 


DS 


CLl 


00002D 








119+ 


OS 


CLl 


00002E 








120+IJDPJ012 


DS 


CL2 


000000 








121+IJDFZZZZ 


CSECT 










00000 


122+ 


USING 


IJDP0012,1 








00000 


123+ 


USING 


*,15 


000000 


0A32 






124+ 


SVC 


IJDL6012 


000002 


0000 






125+ 


DC 


IH'O' 


000004 


0A32 






126+ 


SVC 


IJDL6012 


000006 


0000 






127+ 


DC 


1H«0« 


00000 8 


0A32 






128+ 


SVC 


IJDL6012 


OOOOOA 


0000 






129+ 


DC 


1H'0« 


OOOOOC 


47F0 FOIA 


0001 A 




130+ 


B 


IJDPR012 


000010 


C9D1C4C6E9E9E9E9 




131+ 


DC 


CLB'IJDFZZZZ' 


000018 


2800 






132+ 


DC 


X'2800' MODULE 








OOOIA 


133+IJDPR012 


EQU 


* 


OOOOIA 


OAOO 






134+ 


SVC 


1JDL7012 


OOOOIC 


9180 1002 


00002 




135+ 


TM 


IJDP1012,IJDL8012 


000020 


4710 F026 


00026 




136+ 


BO 


*+6 


000024 


0A07 






137+ 


SVC 


7 


000026 


07FE 






138+ 


BR 


IJDL4012 


000028 


0100 






139+IJDQ8012 


DC 


H'256« 








OOOOB 


140+IJDL1012 


EQU 


11 








OOOOC 


141+IJDL2012 


EQU 


12 








OOOOD 


142+IJDL3012 


EQU 


13 








OOOOE 


143+IJDL4012 


EQU 


14 








OOOOF 


144+IJDL5012 


EQU 


15 








00032 


145+IJDL6012 


EQU 


50 








00000 


146+IJDL7012 


EQU 











00080 


147+IJDL8012 


EQU 


X'80' 








00040 


148+1JDL9012 


EQU 


X'40« 








00020 


149+IJDLA012 


EQU 


X'20' 








00008 


150+IJDLB012 


EQU 


X'08« 



DQS/VS ASSEMBLER REL 28.0 07.19 73/11/0't 



LOGICAL UNIT ADDRESS 
NOT USED 
ADDRESS OF CCW 
STATUS BYTE 
CSW CCW ADDR. 

ADDRESS OF LOGIC MODULE 4-0 
DTF TYPE 
SWITCHES 

NORMAL COMMAND CODE 
CONTROL COMMAND CODE 
ADDRESS OF lOAREA 1 
BUCKET 

L 12,£RECSIZE 
LA 6IOREG,0(14) 
BUCKET FOR PRTOV IF ASA CH 9 
BUCKET FOR PRTOV IF ASA CH 12 
COMMAND CODE 
ADDRESS lOAREA 2 
FLAGS =X'20« 
NOT USED 
COUNT 



CONTROL ERROR 
PRTOV ERROR 
GET ERROR 



BRANCH TO PUT 
MODULE NAME 
CHANGE LEVEL 

EXCP 

WAIT CHANNEL END 



BACK TO USER 

REG 11 
REG 12 
REG 13 
REG 14 
REG 15 
ABEOJ 
EXCP 



4-0 
aDM01457 



4-0 



3-9 
4-0 

3-3 



17200025 
17400025 
17600025 
17800025 
18000025 
18050027 
18400025 
18600025 
18800025 
19000025 
19200025 
19400025 
19600025 
19800025 
20000025 
20200025 
21000025 
21200025 
21400025 
21600025 
21800025 
22000025 
24800025 
25000025 
26000025 
26200025 
27000025 
27200025 
27400025 
27600025 
27800025 
28000027 
28050028 
28400025 
58800025 
59400027 
59600025 
59800025 
60250026 
69700027 
69800025 
70000025 
70200025 
70400025 
70600025 
70800025 
71000025 
71200025 
71400025 
71600025 
71800025 
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PAGE 



LOC 


OBJECT CODE ADDRl 


A0DR2 


STMT SOURCE 


STATEMENT 






DOS/VS ASSEMBLER REL 28.0 


07.19 


73/n/0t| 






00010 


151+IJDLC012 


EQU 


X'lO' 










72000025 






00C04 


152+IJDLD012 


EQU 


X'04« 










72200025 






00006 


153+IJDLE012 


EQU 


X'06' 










72400025 






00001 


154*IJDLF012 


EQU 


X'01» 










72600025 






00002 


155+IJDLG012 


EQU 


X'02« 










72800025 






0008B 


156+IJDLH012 


EQU 


X'8B' 










73000025 






OOOFE 


157+IJDLI012 


EQU 


X' FE« 










73200025 






OOOOB 


158+IJDLJ012 


EQU 


X'OB' 










73400025 






OOOBF 


159+IJDLK012 


EQU 


X' BF' 










73600025 






000F8 


160+IJDLL012 


EQU 


X'F8« 




CCB+3 


ERROR PASSBACK BITS 


3-9 


73650026 






00040 


161+IJDLM012 


EQU 


X«40« 




CCB+2 


ERROR PASSBACK BITS 


3-9 


73700026 






00001 


162+IJDLN012 


EQU 


J. 




REG 1 




3-9 


73750026 






00015 


163+IJDM6012 


EQU 


X' 15' 






DISP FOR SWITCHES 


4-0 


73750527 






00038 


164+IJDM8012 


EQU 


56 






ASOCFLE DISP TN DTF 


4-0 


7375102? 






00023 


165+IJDJM012 


EQU 


X'23' 






FD,SS COMMAND 


4-0 


73751527 






00005 


166+IJD05012 


EQU 


X'05' 






LINE POSITION ZERO FOR 3525 


i 4-0 


73752027 






00080 


167+IJD8D012 


EQU 


X'8D« 






TEST FOR CHANNEL 9 


4-0 


73752527 






OOOBD 


168+IJDBD012 


EQU 


X«BD« 






TEST FOR CHANNEL 12 


4-0 


73753027 






0001 D 


169+IJD1D012 


EQU 


X'lD* 






LINE 3 


4-0 


73753527 






OOOOD 


170+IJD0D012 


EQU 


X'OD« 






LINE 1 


4-0 


73754027 






OOOCD 


171+IJDCD012 


EQU 


X'CD' 






LINE 25 


4-0 


73754527 






00030 


172+IJDV2012 


EQU 


48 






DISP IN PUNCH DTF 


4-0 


73755027 


'007DA8 






173+TEST 


CSECT 












75800025 








174+* IOCS AND DEVICE INDEPENDANT 


I/O ■ 


- DTFCD - 5745-SC-IOX - REL. 28. 





01220028 


0070A8 






175+ 


DC 


OD'O' 










44800025 


007DA8 


00008000C000 




176+ IN PUT 


DC 


X' 000080000000 


ii 


RES. COUNT, COM. BYTES STATUJJ 


45200028 


007DAE 


00 




177+ 


DC 


ALl(O) 






LOGICAL UNIT CLASS 




49800025 


007DAF 


01 




178+ 


DC 


ALKl) 






LOGICAL UNIT 




50000025 


007DB0 


00007DC8 




179+ 


DC 


A{IJCX0013J 




CCW ADDRESS 




50400025 


007DB^ 


00000000 




180+ 


DC 


4X'00' 






CCB-ST BYTE.CSW CCW ADDR. 




51000025 


0P7DB8 


00 




181 + 


DC 


ALKO) 




SWITCH 3 


4-0 


51200027 


00 708 9 


000000 




182+ 


DC 


VL3(IJCFZIZ0) 




ADDRESS OF LOGIC MODULE 


3-3 


53600025 


007DBC 


02 




183+ 


DC 


X'02' 






DTF TYPE (READER) 


JJ 


53940028 


007DBD 


00 




184+ 


DC 


ALKO) 






SWITCHES 




55200025 


007DBE 


02 




185+ 


DC 


AL1(2) 






NORMAL COMMoCODE 




59400025 


007DBF 


02 




186+ 


DC 


AL1(2) 






CNTROL COMM.CODE 




59600025 


007DC0 


00007E58 




187+ 


DC 


A(IN) 






ADDR. OF lOAREAl 




60000025 


007DC4 


00 




188+ 


DC 


ALKO) 








JJ 


60600028 


007DC5 


007D48 




189+ 


DC 


AL3(END) 




EOF 


ADDRESS 


JJ 


60800028 


007DC8 


02007E5820000050 




190+IJCX0013 


CCW 


2,IN,X' 


20S80 








62600025 


007DDC 


4700 0000 00000 




191+ 


NOP 









LOAD USER POINTER REG. 




63000025 


007DD4 


4700 0000 00000 




192+ 


NOP 









MOVE lOAREA TO WORKA 




63800025 


007DD8 


0000 




193+ 


DC 


X'OObO' 










64000025 






07DDA 


194+IJJZ0013 


EQU * 










85800025 








195+* SUPVR COMMN 


MACROS - 


CCB - 


5745- 


SC-SUP - RELo .28o0 




07100028 


007DDA 


0000 




196+TYPECCB 


DC 


XL2'0' . 




1 


RESIDUAL COUNT 




49000028 


007DDC 


0000 




197+ 


DC 


XL2'0' 


• 




COMMUNICATIONS BYTES 




50000028 


007DDE 


0000 




198+ 


DC 


XL2'0' . 




1 


CSW STATUS BYTES 




51000028 


007DEC 


00 




199+ 


DC 


ALKO) 


, 




LOGICAL UNIT CLASS 




52000028 


007DE1 


04 




2 00+ 


DC 


AL1(4) 


, 




LOGICAL UNIT 




53000028 


0070E2 


00 




201+ 


DC 


XLl'O' 










54000028 
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PAGE 



LOC OBJECT CODE 



ADDRl ADDR2 STMT SOURCE STATEMENT 



DOS/VS ASSEMBLER REL 28.0 07.19 73/11/04 



007DE3 OOTDFO 
007DE6 00 
007DE7 000000 
0070EA 000000000000 
0070F0 09007E 0000000025 
007DF8 09007E2500000033 
007E00 C9E5D7C3C1D74040 
P07E25 C9E5n7C3ClD74040 

007E58 

007EA8 5B5BC2D6D7C5D540 
007EB0 5B5BC2C3D3D6E2C5 
007EB8 00007DA8 
007EBC 00007D78 



OOOOB 
07D00 



202+ 
203+ 
204+ 

205+TYPECCW 

2 06+TYPNCCW 

2 07+ MS GST 

2 08+ MS GEN 

209+REG 

210+lN 

211 

212 

213 

214 

215 



DC AL3(TYPECCW) 

DC B« 00000000" 

DC AL3(0) . 



CCW ADDRESS 

STATUS BYTE 
CSW CCW ADDRESS 



CCW 9,MSGST,0,L'MSGST 

CCW 9,MSGEN,0,L»MSGEN 

DC CMVPCAP STARTED ++++++++++++++++++++« 

DC CMVPCAP COMPLETED SUCCESSFULLY ++++++++++++++++++++• 

EQU 11 

DS CL80 

END START 

=C'/fBOPEN ' 

=C'/f BCLOSE* 

=A(INPUT) 

=A(OUTPUT) 



55000028 
56000028 
57000028 

45000028 
46000028 
47000028 
48000028 
49000028 
50000028 



RELOCATION DICTIONARY 



ESDID FOR 


ESDin FOR 


TYPE 


LENGTH 


ADDRESS 


ADOR CON 


REF SYMBOL 








01 


+ 01 


A 


4 


007D20 


01 


+ 01 


A 


4 


007D24 


01 


+01 


A 


4 


007D50 


01 


+ 01 


A 


4 


007054 


01 


+ 01 


A 


4 


007080 


01 


+02 


V 


3 


007D89 


01 


+ 01 


A 


4 


007090 


01 


+ 01 


CCW 


3 


00 7 DAI 


01 


+01 


A 


4 


007 D BO 


01 


+04 


V 


3 


007 DB9 


01 


+ 01 


A 


4 


007 DCO 


01 


+01 


A 


3 


0070C5 


01 


+ 01 


CCW 


3 


007 DC9 


01 


+ 01 


A 


3 


007DE3 


01 


+01 


CCW 


3 


007DF1 


01 


+ 01 


CCW 


3 


0070F9 


01 


+ 01 


A 


4 


007 EB8 


01 


+01 


A 


4 


007 EBC 



PAGE 7 
73/11/04 
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CROSS-REFERENCE 



SYMBOL 


LEN 


ID 


VALUE 


DEFN 


REFERENCES 


END 


00004 


01 


007048 


00054 


0189 


IJCX0013 


00008 


01 


007DC8 


00190 


0179 


IJDBD012 


00001 




OOOOBD 


00168 




IJDCD012 


00001 




OOOOCD 


00171 




IJDFZZZZ 


00001 


03 


000000 


00121 




IJDJM012 


00001 




000023 


00165 




IJDLA012 


00001 




000020 


00149 




IJDLB012 


00001 




000008 


0015 




IJDLC012 


00001 




000010 


00151 




IJDLD012 


00001 




000004 


00152 




IJDLE012 


00001 




000006 


00153 




IJDLF012 


00001 




000001 


00154 




IJDLG012 


00001 




000002 


00155 




IJDLH012 


00001 




00008B 


00156 




IJPLI012 


00001 




OOOOFE 


00157 




IJDLJ012 


00001 




OOOOOB 


00158 




IJDLK012 


00001 




OOOOBF 


00159 




IJDLL012 


00001 




0000F8 


00160 




IJDtM012 


00001 




000040 


00161 




IJDLN012 


00001 




000001 


00162 




IJDLini2 


00001 




OOOOOB 


00140 




IJDL2012 


00001 




OOOOOC 


00141 




IJDL3012 


00001 




OOOOOD 


00142 




IJDL4012 


00001 




OOOOOE 


00143 


0138 


IJDL5012 


00001 




OOOOOF 


00144 




IJDL6012 


00001 




000032 


00145 


0124 0126 1 


IJ0L7012 


00001 




000000 


00146 


0134 


IJ0L8012 


00001 




000080 


00147 


0135 


IJDL9012 


00001 




000040 


00148 




IJ0M1012 


00004 


FF 


000010 


00105 




IJDM6012 


00001 




000015 


00163 




IJDM8012 


00001 




000038 


00164 




IJDPA012 


00001 


FF 


000017 


00109 




IJDPB012 


00002 


FF 


00002 


00112 




IJDPC012 


00004 


FF 


000022 


00113 




IJDPD012 


00001 


FF 


000000 


00095 




IJDPE012 


00001 


FF 


00002 6 


00114 




IJDPF012 


00001 


FF 


000027 


00115 




IJDPG012 


00001 


FF 


00002 8 


00116 




IJDPH012 


00003 


FF 


000029 


00117 




IJDPI012 


00001 


FF 


00002C 


00118 




IJDPJ012 


00002 


FF 


00002E 


0012 




IJDP0012 


00002 


FF 


000004 


00099 




IJ0PR012 


00001 


03 


OOOOIA 


00133 


0130 


IJDPn012 


00002 


FF 


000000 


00096 


0122 


IJDP1012 


00001 


FF 


000002 


00097 


0135 


IJDP2012 


00001 


FF 


000003 


00098 




IJDP3012 


00002 


FF 


000006 


00100 




IJDP4012 


00003 


FF 


000009 


00102 




IJDP5012 


00001 


FF 


000014 


00106 




IJDP6012 


00001 


FF 


000015 


00107 





PAGE 8 

73/n/n't 



0128 
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CROSS-REFERENCE 



PAGE 



SYMBOL 


LEN 


ID 


VALUE 


OEFN 


REFERENCES 


IJDP7012 


00P04 


FF. 


000018 


00110 








IJDP8012 


00004 


FF 


OOOOIC 


00111 








IJDP9012 


00001 


FF 


000016 


00108 








IJDQ8012 


00002 


03 


000028 


00139 








IJDV2012 


00001 




000030 


00172 








IJ00D012 


00001 




OOOOOD 


00170 








IJD05012 


00001 




000005 


00166 








IJ01D012 


00001 




00001 D 


00169 








IJD8D012 


00001 




00008D 


00167 








IJJC0007 


00004 


01 


007D4C 


00056 








IJJOPOOA 


00004 


01 


007D1C 


0003 8 








IJJZOOll 


OOOOI 


01 


007DA8 


00093 








IJJZ0013 


00001 


01 


007DDA 


00194 








IN 


00080 


01 


007E58 


00210 


0087 


0092 


0187 


INPUT 


00006 


01 


007DA8 


00176 


0039 


0057 


0214 


LABEL 


00004 


01 


007D2A 


00044 


0051 






MSGEN 


00051 


01 


007F25 


002 08 


0206 


0206 




MSGST 


00037 


01 


007E00 


00207 


0205 


0205 




OUTPUT 


00006 


01 


0070 78 


00076 


0040 


0058 


0215 


REG 


00001 




OOOOOB 


00209 


0025 


0027 


0030 


START 


00002 


01 


007D00 


00023 


0211 






TEST 


00001 


01 


007D00 


00001 


0173 






TYPECCB 


00002 


01 


007D0A 


00196 


0025 


0061 


0062 


TYPECCW 


00008 


01 


007DF0 


002 05 


0202 






TYPNCCW 


00008 


01 


007DF8 


00206 


0060 






=A( INPUTl 


1 
















00004 


01 


007 EB 8 


00214 


0044 






=A(OUTPUT> 
















00004 


01 


007EBC 


00215 


0048 






=C'/fBOPEN • 
















00008 


01 


007EA8 


00212 


0037 






= C«i'/BCLOSE' 
















00008 


01 


007EB0 


00213 


0055 







73-n-0«t 



0190 



0060 0061 0062 0064 0067 
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DIAGNOSTICS AND STATISTICS PAGE 10 

STMNT ERROR NO. MESSAGE 73-n-O't 

61 IPK182 ALIGNMENT ERROR IN OPERAND 2 

THE FOLLOWING MACRO NAMES HAVE BEEN FOUND IN MACRO INSTRUCTIONS 

IVPCAPS EXCP WAIT OPEN GET PUT CLOSE EOJ DTFPR PRMOD DTFCO CCB BTWAIT 

OPTIONS FOR THIS ASSEMBLY - ALIGN, LIST, XREF, LINK, DECK, NOEDECK 

THE ASSEMBLER WAS RUN IN 204680 BYTES 
END OF ASSEMBLY 



ENTRY 
// EXEC LNKEDT 



JOB IVPCAP2 t1/04/73 DOS LINKAGE EDITOR DIAGNOSTIC OF INPUT 

ACTION TAKEN MAP REL 
LIST AUTOLINK IJCFZIZO 
LIST ENTRY 



n/O't/73 PHASE XFR-AD LOCORE HICORE DSK-AD ESD TYPE LABEL LOADED REL-FR 

PHASE*** 080078 080078 0802D3 047 07 2 CSECT TEST 080078 078378 RELOCATABLE 

CSECT IJDFZZZZ 080238 080238 

CSECT IJCFZIZO 080268 080268 
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// JOB IVPCAP3 

* DELETE IVPCAPl FROM PROCEDURE LIBRARY 

// EXEC MAINT 



DATE 11/04/73, CLOCK 07/20/36 



DELETP IVPCAPl 



PRIVATE DIRECTORY 
11 /04/73 



DIRECTORY STARTING ADDRESS 
DIRECTORY NEXT ENTRY 
DIRECTORY LAST ENTRY 

LIBRARY STARTING ADDRESS 
LIBRARY NEXT AVAILABLE ENTRY 
LIBRARY LAST AVAILABLE ENTRY 



DIRECTORY ENTRIES ACTIVE 

LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 

LIBRARY BLOCKS DELETED 

LIBRARY BLOCKS AVAILABLE 

AUTOMATIC CONDENSE LIMIT 

LIBRARY ALLOCATED CYLINDERS 
DIRECTORY ALLOCATED TRACKS 



PRV-CORE 


IMAGE 


PRV -RELOCATABLE 


PRV- SOURCE STATEMENT 










.^.__^ ncrTMAi 








C 


H 


R 


E 


c 


H R E 


C 


H 


R E 


47 


10 


01 




73 


00 01 


103 


00 


01 


47 


12 


06 


08 


73 


02 09 16 


103 


01 


15 07 


47 


14 


15 


17 


73 


09 17 19 


103 


09 


27 09 


47 


15 


01 




73 


10 01 


103 


10 


01 


71 


07 


02 




98 


10 12 


196 


05 


02 


72 


19 


04 




102 

.__CT ATI IC 


19 16 

TMCnDMAT TOM... 


196 


19 


27 


637 








■— — o 1 A 1 Uo 

849 


INrUrsriAl lUiN 


412 






2020 








9440 




50490 






1861 








7922 




50086 






28 








89 




00 






131 








1429 




404 






00 








00 




00 






26 








30 




94 






05 








10 




10 







SYSTEM DIRECTORY—SYSRES 
11/04/73 



DIRECTORY STARTING ADDRESS 
DIRECTORY NEXT ENTRY 
DIRECTORY LAST ENTRY 

LIBRARY STARTING ADDRESS 
LIBRARY NEXT AVAILABLE ENTRY 
LIBRARY LAST AVAILABLE ENTRY 



DIRECTORY ENTRIES ACTIVE 

LIBRARY BLOCKS ALLOCATED 

LIBRARY BLOCKS ACTIVE 

LIBRARY BLOCKS DELETED 

LIBRARY BLOCKS AVAILABLE 

AUTOMATIC CONDENSE LIMIT 

LIBRARY ALLOCATED CYLINDERS 
DIRECTORY ALLOCATED TRACKS 



CORE- 


-IMAGE 


RELOCATABLE 


SOURCE-; 


STATEMENT 


PROCEDURE 
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EMA - 1401/1440/1460 Emulator 



Functions Tested: 



Three verification procedures are provided with the emulator: 

• One to be used with an eirulatcr generated for a 1401 or a 1460, with 
the following options: advanced prograirming , sense switches, and 
1400 console. 

• One to be used with an eirulatcr generated for a 1401 or a 1401G or a 
146 without the above options. 

• One to be used with an emulator generated for a 144 with the options 
advanced programming ahd sense switches. 



IVPGEN MACRO OPTIONS 



NOJ Specify if the DOS/VS 1401/1440/1460 Emulator program 
EMA=/YEs( is to be verified. 



(1401 j 
EMATYPE=jl440 
(l40lG 



Specify the required verification procedure. 

1401 : Verification procedure for a 1401/1460 emulator 

with options. 
144 : Verification procedure for a 1440 emulator. 
1401G: Verification procedure for a 1410/1460 emulator 

without options, or verification procedure for 

a 1401G emulator. 



EMANAME=X Specify the phasename under which the emulator is 
cataloged in the core image library. 



Optional Parameters 



Specify the following two parameters only if ycu want to verify the tape 

f nnnt-ions. 



EMATSN=SYSnnn 



Specify the logical name of the tape device assigned to 
the 1400 tape unit 1. This unit must have been defined 
in an EMTAPE emiulator macro instruction. D o not 
spe cif y this parameter if spanned tape format has been 
specified (TPSUP=SPANNED in the EMSUP emulator macro 
instruction) , or if the emulator does net emulate the 
tapes (TPSUP=NCNE in the EMSUP macro instruction) . 



EMATA=cuu Device address of the tape drive. 
EMATSN=SYSnnn is also specified. 



Specify only if 
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Note that only one emulator program can be executed during one IVP 
run and that, conversely, this emulator can execute only one of the 
verification procedures. 

In addition to testing the 1400 CPU functions and the operator 
communication functions, the verification procedures: 

• Read data from the System/370 device assigned as 14 00 card reader 

• Punch data on the System/370 device assigned as 1400 card punch 

• Print the data read from the 14 00 card reader on the System/370 
device assigned as 1400 printer. 

If the System/370 configuration includes a tape unit, the verification 
procedures (except those for the 1401G or the 1401/1460 without options) 
optionally write on and read from tape in 1400 format (TPSUP=ORIGINAL or 
MIXED in the EMSUP emulator macro instruction). 

The verification procedures contain 1400 object programs and data as 
well as the DOS/VS control cards required to execute the emulator. You 
can perform the verification procedures with the eirulatcr generated in 
accordance with your specifications and cataloged to the core image 
library. 

However, the verification procedures cannot be used with an emulator 
generated to handle: 

• column binary data 

• card image data 

• 51-column cards. 

A 1401/1440/1460 emulator must emulate real storage of a size of at 
least 4,000 bytes. 

A 1401G emulator must emulate real storage of a size of at least 
4,000 bytes. 



SOFTWARE REQUIREMENTS 

Emulator Macro Options 

The following emulator instructions generate a minimum emulator to 
execute the verification procedures (does net apply to the 1401G 
emulator) : 

EMULATOR CPU=XXXX , C0RE=4 , ADVPROG=YES , SENSESW=YES , M0DEL=14 5 

EMSUP EMNAME=EMSPL01,CCRDR=SYSRDR, X 

TPSUP=ORIGINAL , CONSOLE=YES 
EMRDR TODEV=2540 
EMPNCH FROMDEV=1402,TCDEV=2540 
EMPTR FROMDEV=140 3,TCDEV=1403 
EMTAPE DEVADDR=SYS06l,UNIT=l, X 

TYPEFLE=OUTPUT,RECFM=ORIGINAL,ELKSIZE=80 
EMEND 
END 

Notes 

1. xxxx in the EMULATOR macro can be either 1401,1440, or 1460. 
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2. The EMTAPE macro specification is not required if no tape functions 
are to be verified. 

For a moiG the minimuni emulator is generated as follows: 

EMULATOR CPU=1401G,CORE=4 , ADVPROG=YES, SENSESW=YES,M0DEL=1U5 

EMSUP EMNAME=EMSPL01,CCRDR=SYSRDR 

EMRDR TODEV=2540 

EMPNCH FR'OMDEV=m02,TODEV=25t40 

EMPTR FROMDEV=l£t03,TODEV=14 03 

EMEND 

END 

The logical names of the Systeiii/370 devices assigned as 1400 reader,, 
punch, and printer are by default SYSIPT, SYSPCH, and SYSLST. If you 
specified logical names in the forir DEVADDR=SYSnnn, be sure that these 
devices relate to the same devices as SYSIPT, SYSPCH, and SYSLST. 



HARDWARE REQUIREMENTS 

A Central Processing Unit equipped with: 

• The IBM Compatibility Feature 4457 for Models 125 and 135 

• The IBM Compatibility Feature 4457 or 4458 for Model 145 

• Standard instruction set 

• One tape drive, if the tape functions are to be verified 

STORAGE REQUIREMENTS 

The amount of storage required depends on what you specify when 
generating your emulator. The emulator described in the section 
"Software Requirements" takes up approximately 27,500 bytes of storage 

OPERATING INSTRUCTIONS 

1. Set-Up Requirements. 

None,, if tape functions are not to be verified. Otherwise, mount a 
scratch tape on the tape unit assigned to 1400 tape unit 1. 

2. Operating Instructions. 

I Type in START in response to message 

EN021D IVPEMA HALT IAR=nnnnnn 
AAR=00001/2 BAR=00001/2 
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EMB - 1410/7010 Emulator 

Functions Tested: 



1410/7010 CPU functions 

Operator coimnuni cation functions 

Console operations 

Tape functions - 14 00 forirat (optional) 



IVPGEN MACRO OPTIONS 



EMB=j NO j Specify if the DOS/VS 1410/7010 Emulator program is to be 
[YES I verified. 



Requ ire d Pa rameter 

EMBNAME=x Specify the phase name under which the emulator is cataloged 
in the core image library. 



Optional Parameters 



EMETSN=SYSnnn Specify the logical name of the System/370 tape device 
assigned to 14 00 tape unit 1, channel 1. 

EMBTA=cuu Device address of the tape drive. Specify only if 
EMATSN=SYSnnn is also specified. 

In addition to testing the 1410/7010 CPU functions and the operator 
communication functions, the verification procedures: 

• Read data from the Systeit/370 device assigned as 14 00 card reader 

• Punch data on the System/370 device assigned as 1400 card punch 

• Print the data read from the 14 00 card reader on the System/370 
device assigned as 1400 printer. 

If the System./370 configuration includes a tape unit the verification 
procedures optionally write on and read from tape in 1400 format 
(TPSUP=ORIGINAL or MIXED in the EMSUP emulator macro instruction) . 

The verification procedure comprises a 1400 object program and data 
as well as the DOS/VS control cards required to execute the emulator 
program. You can perform the verification procediires with an emulatcr 
generated in accordance with your specifications and cataloged to the 
core image library. 

The minimum amount of storage that can be handled by a 1410/7010 
emulator is 40,000 bytes. 

For a 1410 emulator the EMULATOR macro instruction must specify 
URCHAN=1 and OVERLAP=YES, in addition to the selected parameters. 
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SOFTWARE REQUIREMENTS 

The following instructions will generate a rriniituni size emulator to 
execute the verification procedures: 

EMULATOR CPU=xxxx,, C0RE=4 , CHAN=1 , URCHAN=1 , OVERLAP=YES , MCDEL=1 45 

EMSUP EMNAME=EMSPL10,CCRDR=SYSRDR, X 

TPSUP=ORIGINAL 
EMRDR TODEV=2540 
EMPNCH TODEV=25£*0 
EMPTR TODEV=1403 
EMTAPE DEVADDR=SYS001,UNIT=11, X 

TYPEFLE=OUTPUT,RECFM=ORIGINAL,BLKSIZE=80 
EMCNSL 
EMEND 
END 

No te s; 

1. xxxx in the EMULATOR macro can be either 1410 cr 7010. 

2. Do not specify OVERLAP=YES if CPu=7010 is specified. 

The logical names of the System/370 devices assigned as 1400 reader, 
punch, and printer are by default SYSIPT, SYSPCH and SYSIST, If ycu 
specified logical names in the form DEVADDR=SYSnnn, be sure that these 
devices relate to the same devices as SYSIPT, SYSPCH, and SYSLST. 



HARDWARE REQUIREMENTS 



A Central Processing Unit equipped with: 

• The IBM compatibility Feature UU58 for Models 145 

• Standard instruction set 

• One tape drive, if tape functions are to be verified 



STORAGE REQUIREMENTS 

The amount of storage required is dependent on what you specify when 
generating your emulator. The emulator described in the section 
"Software Requirements" takes up approximately 27,500 bytes of storage 



OPERATING INSTRUCTIONS 



1 • Set-Up Requirements 

None, if tape functions are not to be verified. Otherwise, mount a 
scratch tape on the tape unit assigned to 1400 unit 1, channel 1. 

2 . Operating I nstruction s 

On display of message 
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EP022D IVPEMB HALT/BRANCH IAR=nnnnn AAR=xxxxx BAR=xxxxx DM0D=1 

• Type in START if nnnnn=06106 

• Type in EOJ if nnnnn is not 06106 

E20 - Sy8tem/360 Model 20 Emulator 

Function s Tested 

The Installation Verification Procedure for the SysteHi/3&0 Model 2Q 
emulator tests the following Model 20 functions: 

• CPU instructions 

• Interrupt capability 

• CPU data and address checking 

• Operator communications 

• I/O operations for each type of device the emulator program suf>^p«rts. 

Note; If the E20 verification procedure makes use of a read/punch 
device (2520 or 2560) it can be used for only cne run. For a followijag 
run it is necessary to assemble the IVPGEN macro again. 



IVPGEN MACRO OPTIONS 



E20=j NOl Specify if the DOS/VS Systero/360 Model 20 Emulator profra«B 
[YES I generation is to be verified. 



Required Paramete r 



E20NAME=xxxx Specify the phase name under which the ewulatcr is 

cataloged in the core iniage library. Length of the phase 
name may be from four to seven characters. 



HARDWARE REQUIREMENTS 

• a reistral Processing Unit equipped with the IBM Compatibility Feature 
7520 for Models 125 and 135 and a standard instruction set. 

• One physical device for each Model 20 device emulated. 

If the System/360 configuration comprises am MFCH, note that the 
emulation can either be .performed on a Syste«i/370 MFCM ©r on tfee 
combination of a 350U/3505 and a 3525. The MFCM is emulated at DOS/VS 
level by two physical devices, therefore, enter two ASS€N comRian^s. 
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OPERATING INSTRUCTIONS 

1 • Set-Up Requ irements 

The system printer must be provided with a carriage control tape 
with punches in (at least) channels 1, 9, and 12. 

2 . Operating Instructions 

In response to message 

E201D 01 STOP UL=99,PSW=0100062C,ESTR=OFFF 

type in EOJ to pass control to DOS/VS job control. 
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Example of SYSLQG Output 

BG // JOB IVPE20 

DATE 11/04/73, CLOCK 23/33/07 

BG * INSTALLATION VERIFICATION PROCEDURE FOR MODEL 20 EMULATOR ON S/370 

BG * YOU MUST ASSIGN EACH LOGICAL UNIT USED IN THE EMULATOR GENERATION TO 

BG * A VALID S/370 PHYSICAL DEVICE 

BG * FOR EXAMPLE M2Q 2501 CARD READER HAS BEEN GENERATED ON SYS00i+ 

BG * YOU MUST ENTER THE FOLLOWING DOS COMMAND 

BG * // ASSIGN SYS004,X» 00C» 

BG * ASSUMING THAT QOC IS A VALID CARD READER TYPE FOR EMULATION 

BG * YOU MUST DO THAT FOR M20 2501 2520/2560 1442 1403/2203 AND TAPES 

BG // PAUSE PLEASE ENTER YOUR ASSIGN COMMANDS NOW 

BG // ASSGN SYS004,X' OOC 

BG // ASSGN SYSOl O^X' 280' 

BG // ASSGN SYSOl 1,X' 281 ' 

BG 

BG // PAUSE IT IS YOUR LAST CHANCE FOR ENTERING ASSGN COMMANDS 

BG 

BG // EXEC EMUL3 

BG E220D ENTER 'DI ON' COMMAND FOR DEVICE INDEPENDENCE, IF NOT 'DI OFF' 

BG DI OFF 

BG E201D 01 STOP UL=99, PSW=O0 00 1 F8 , ESTR=000 

BG S 

BG E201D 01 STOP UL=99, PSW= 1 Oa047E, ESTR=000 1 
[ BG CF.S 

BG TAPES 081=SYS011 OBO^SYSOIG 

BG DISKS 002=AAAAAA 002=BBBBBB 

BG UR 2501=SYS004 1442=SYSPCH 1 40 3/ 220 3=SYSLST 

BG E201D 01 STOP UL=9 9, PSW= 1 00 0482, ESTR=0 3 86 

BG S 

BG E201D 01 STOP UL=9 9 , PSW=0 1 04A6, ESTR=250 1 

BG S 

BG E201D 01 STOP UL=:99, PSW=0 1 0004EE, ESTR= 1 442 

BG S 

BG E201D 01 STOP UL=99 , PSW=0 1 5 OE, ESTR= 1 40 3 

BG S 

BG E201D 01 STOP UL=99, PSW=0 1 5 1 E, ESTR=0 70 

BG S 

BG E201D 01 STOP uL=99 , PSW=3 1 Q 542 , ESTR-OOO 2 

BG S 

BG E202D MOD20 PROGRAMMING ERROR UL=FA, 1=0 7, PSW=0 1 5F2 

BG CS SD=X'5F2' 

BG 5F2 FA440B820B82488006204A80068C4B80 

BG CS DS=X'B82' 

BG B82 00000000000000000000000000000000 
I BG CS SA=CX' B82' ,X'000000001C'). S 

BG E202D MOD20 PROGRAMMING ERROR UL=4A, 1=0 8, PSW= 1 1 00 06 1 2 

BG HELP 

BG E2121 CONSULT 'UL' AND 'PSW' WHICH SPECIFY ERROR TYPE AND ADDRESS - 

BG E2121 - OF INSTRUCTION IN ERROR 

BG E2121 USE 'CS' COMMAND, FOLLOWED BY 'S' TO CORRECT THE ERROR 

BG E2121 IF THE ERROR PERSISTS, ENTER ' DF ED,TD,EDJ' TO CANCEL EMULATOR RUN 
I 3G CS RA=C8,X'0' ).S 

. BG E202D MOD20 PROGRAMMING ERROR UL= 1 A, 1 = 8, PSW= 1 1 00 06 1 A 
I BG CS RA=C8,X'0' ).S 

BG E2Q1D 01 STOP Ui; =9q _, PSW=0 1 00062 8 . ESTR=00 3 

BG S 

BG E201D 01 STOP UL=99, PSW=0 1 0006 2C, ESTR=OFFF 

BG S 

BG E201D 01 STOP UL=99, PSW=0 1 00062C, ESTR=OFFF 

BG EOJ 

BG * IVPE20 IS FINISHED 

BG EOJ IVPE20 

DATE 1 1/04/73, CLOCK 23/ 04/ 8, DURAT ION 00/07/00 
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Example of SYSLST Output 



// JOB IVPE20 DATE n/0'+/73^CLOCK IZllZl^l 

* INSTALLATION VERIFICATION PROCEDURE FOR MODEL 20 EMULATOR ON S/370 
YOU MUST ASSIGN EACH LOGICAL UNIT USED IN THE EMULATOR GENERATION TO 
A VALID S/370 PHYSICAL DEVICE 

FOR EXAMPLE M20 2501 CARD READER HAS BEEN GENERATED ON SYS004 
YOU MUST ENTER THE FOLLOWING DOS COMMAND 

// ASSGN SYS0O4,X'00C' 
ASSUMING THAT OOC IS A VALID CARD READER TYPE FOR EMULATION 
YOU MUST DO THAT FOR M2C 2501 2520/2560 ]kk2 1 i+03/ 2203 AND TAPES 

PAUSE PLEASE ENTER YOUR ASSGN COMMANDS NOW 

ASSGN SYSOO'+^X'OOC 

ASSGN SYS01C,X'280' 

ASSGN SYSOl 1,X»281 ' 

PAUSE IT IS YOUR LAST CHANCE FOR ENTERING ASSGN COMMANDS 

EXEC EMUL3 



* 
* 
* 
* 
* 
* 
* 

// 
// 
// 
// 
// 
// 
DI 
EC 
LD 



OFF 
DC=V/LC' 



SAMPLE OUTPUT DATA 
SAMPLE OUTPUT DATA 

SAMPLE OUTPUT DATA 
NOW SKIP TO CHANhfEL T. 

NOW SKIP TO CHANNEL 12 

NOW SKIP TO CHANNEL 09 



THE 18 FIRST CHARACltKS OP THIS LINE ARE THE 
SAME AS THOSE OF THE PREVIOUS LINE 



* IVPE20 IS FINISHED 
EOJ IVPE20 



DATE n/0i+/73, CLOCK 2 3/^10/ 08, DURAT I ON 00/07/00 



YOU HAVE GENERATED THE FOLLOWING MODEL 20 CONFIGURATION 

2501 CARD READER 

1442 CARD PUNCH 

1403/2203 PRINTER 
YOUR TAPE UNIT ADDRESSES ARE = 80 81 
YOU HAVE GENERATED STORAGE CONTROL FEATURE 
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OLT - OLTEP 

Fun ctio n Tested 

• The possibility of initializing online testing. 

OPERATING INSTRUCTIONS 

Action Messages 

01E105D ENTER-DEV/TEST/OPT/ 

Reply by typing in 
R 01, 'CANCEL* 
to terminate the execution of the OLTEP verification procedure. 

PWR - POWER 

Function Tested 

A test is made to see if the version of POWER generated functions in 
accordance with the specifications. 

SOFTWARE REQUIREMENTS 

POWER=YES must have been specified as a SUPVR iracrc parameter when 
assembling the supervisor. POWER trust be running while the test is 
being made. 
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UTL - System Utilities 

Functio ns Tested 

Standard 

CLRDK Clear Disk 

CDKCD Copy disk to card 

CDKDK Copy disk to disk 

RCDDK Restore card to disk 

LVTOC VTOC display 

Note; If the PCHADDR parameter is not specified, CDKCD and RCDDK will 
not be verified. 

Optional 

• If UTLT=YES is specified in the IVPGEN iracrc: 

INTTP Initialize tape 
CDKTP Copy disk to tape 
RTPDK Restore tape to disk 

• If UTLZ=YES is specified in the IVPGEN iriacro: 

CLRDC Clear data cell 

CDKTP Copy data cell to tape (only if UTLT=YES is specified) 

RTPDK Restore tape to data cell 



HARDWARE REQUIREMENTS 



Required: 2 direct-access devices 
1 printer. 

Optional: 1 tape drive 

1 data cell drive 
1 card reader 
1 card punch. 
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Module 4: 1401/1440/1460 DOS/VS Emulator 

on System/370 -.5745-SC-EML 



Modular Outline 



Partition Size Required 272 

Source Statement Library 272 

Macros 272 

Delete Statements 272 

Relocatable Library 272 

Link-Edit Statements .273 

Delete Statement 273 

Core Image Library 273 

Transients 273 

Phases 273 

Delete Statements 273 

Sample Program 273 

Sample Program Summary . . 274 
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The l^Ol/llUO/lteO Emulator Prcgrarr for the 
IBM System/370 consists of a group of iracro 
instructions and object and load ircdules 
that are shipped in the source statement, 
relocatable, and core image libraries. Two 
sample programs that test the working cf a 
1U01/1U60 program, of a 1440 program, and 
of a 1401G program under the emulator are 
contained in the source statement library 
under the name Z.EMSPLOl. The source cards 
of this program are cataloged under the 
name Z.EMSPLOIS. 



I 



E.IIQBR 
E.IIQCR 
E.IIQDS 
E.IIQEI 
E.IIQID 

E.IIQIU 

E.IIQOJ 

E.IIQUR 

E.IVPEMAC 

E.MCPU 

E.MIO 

E.MULDIV 



PARTITION SIZE REQOIRED 

This emulator program requires at least a 
20,480 byte partition. For further 
information, refer to the emulator 
publication. 



SOURCE STATEiyJENT LIBRARY 



Delete Statements 



DELETS E.ANUM 
CELETS E.ECIL 
EELETS E.EIFLAG 
DEIETS E.CCMP 



I I 



Number of 
Macros 



Number cf 
Library Blocks 
(Physical Records) 



31 



5942 



-^ 



N ote : 21 macros are common to the 
1401/1440/1460 and the 1410/7010 emulators, 
The macros marked with an asterisk below 
are unique to the 1401/1440/1460 emulator. 



DELETS E.MIO 

Note: The 21 macros that are common to the 
1401/1440/1460 and the 1410/7010 emulators 
should not be deleted for a system that is 
to contain a 1410/7010 emulator. Delete 
only those macros that are unique to the 
1401/1440/1460 emulator. 



RELOCATABLE LIBRARY 



Macros 



E.ANOM 

E.BDIL 

E.BIFLAG 

E.CCMP 

E.DEIB 

E.DDTF 

E.DDUB 

E.DIIQCR 

E.DIL 

E.DSUB 



r T 1 

I Number cf | Number of Library Blocks | 
I Modules I (Physical Records) j 
^ 4 ^ 

I I 29 I 244 I 

L X J 



Module Name 

IIQAP 
IIQBF 
IIQBY 
IIQCC 
IIQCF 



Bytes of 
St or age 

345 

250 

448 

1675 

2464 



E.EMCNSL 
E.EMDISK 
E. EMEND 
E.EMPNCH 
E.EMPTR 



IIQCN 
IICCP 
IIQCS 
IIQDB 
IIQDI 



731 
412 
5362 
764 
794 



E.EMRDR 
E.EMSUP 
E.EMTAPE 
E. EMULATOR 
E.EMVERIFY 



IigDK 
IIQEJ 
IIQEP 
I IIQEPl 
IICMC 



2101 
290 
754 

486 
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IIQMD 
I IIQMDl 



IIQMT 

IIQMTP 

IIQMW 

IIQNT 

IIQOA 

IIQOB 

IIQPOST 

IIQPRE 

IIQSD 

IIQTP 

IIQURl 

IIQVT 



806 



629 

741 

592 

2708 

1674 

1538 
6065 
7075 
390 
1841 
1389 
3376 



Transients 



$$EIIQBD 
$$EIIQES 
$$EIIQMW 
$$EIIQSD 
$$EIIQSS 



$$BIIQT1 
$$EIIQT2 
$$EIIQT3 
$$EIIQT4 
$$BIIQT5 
$$EIIQT6 



Link-Edit Statements 



Phases 



Tape Preprocessor Program 

PHASE phasename,*,NGAUTO 

INCLUDE IIQMTP 

INCLUDE IIQPRE 

ENTRY IIQPRE 
/* 

// LBLTYP TAPE 
// EXEC LNKEDT 



Tape Postprocessor Program 

PHASE phasename, *,NOAUTO 

INCLUDE IIQMTP 

INCLUDE IIQPOST 

ENTRY IIQPOST 
/* 

// LELTYP TAPE 
// EXEC LNKEDT 



IIQOC 
IIQOD 
IIQOE 
IIQOF 



IIQOG 
IIQOH 
IIQOI 
IIQOK 



DeXete Statecnents 



CELETC IIQC.ALL 
EELETC $$EIIQED 
EELETC $$EIIQBS 
EELETC $$EIIQMW 



Delete statement 



DELETR IIQ.ALL 



EELETC $$EIIQT6 



CORE IMAGE LIBRARY 

r T 1 

I Phases | Blocks | 

r + + i 

1 Transients | 11 | 11 | 
^ + 4 ^ 

1 Phases | 8 | 16 j 
L X X J 



SAMPIE PRCGRAM 



Z . EMSPLOl , Z . EMSPLOIS 
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SAMPLE PROGRAM SUMMARY; Figure 4-1 
illustrates the card deck that is punched 
when the sample prograirs are retrieved froir 
the source statement library. 



j Cards Retrieved 

j. 

CATALS Z . EMSPLOl ,4.0 
EKEND Z. EMSPLOl 

1400 object decks and source decks 
EKEND 

CATALS Z.EMSPL01S,4.0 
EKEND Z.EMSPLOIS 

1400 source deck 
EKEND 



The sample program lists 20 records on 
the printer, and it writes out the records 
en tape if tape is available and assigned. 
For a complete description of the sample 
programs, refer to the 1401/1440/1460 
Emulator manual. 



Figure 4-1. Sample Program Card Deck, 
1401/1440/1460 Emulator 
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Module S: 1410/7010 DOS/VS Emulator 
on Sy8tem/370 -B745-SC-EML 



Modular Outline 



Partition Size 276 

Source Staterrent Library 276 

Macros 276 

Delete Statements 276 

Relocatatle Library ......... 276 

Link-Edit Statements 277 

Delete Statement . 277 

Core Iirage Library 277 

Transients 277 

Phases . * 277 

Delete Statements 277 

Sairple Program 277 

Sairple Program Suirrrary 278 
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The lUlO/7 010 Emulator Program consists of 
a group of macro instructions and object 
and load modules that are shipped in the 
source statement, relocatable, and core 
image libraries. A sample program that 
tests the working of a 1410 and 7010 
program under the emulator is contained in 
the source statement library under the name 
Z.EMSPLIO. The source cards of this 
program are cataloged under the name 
Z.EMSPLIOS. 



E.EMVERIFY 

E.IIRCR ♦ 

E.IIRDCC * 

E.IIREI ♦ 

E.IIRID ♦ 

E.IIRIU * 

E.IIROJ * 

E.IVPEMBC * 
E.MCPU 
E.MIC 



PARTITION SIZE 

30ff000 bytes. For further information, 
refer to the Emulator publication. 



Source State ment Li b ra ry 



Delete Statements 



DELETS E.ANUM 
DELETS E.EDTL 
DELETS E.EIFLAG 



r " T 1 

I Number of | Number of | 
I Macros I Library Blocks j 
I I (Physical Records) | 
^ + . . ^ 

I 30 I 3,249 I 

L i J 

N ot e: 21 macros are common to 
1401/1440/1460 and 1410/7010 emulators. 
The macros marked with an asterisk belcw 
are those that are unique to the 1410/7010 
emulator. 



Macros 



DELETS E.MIO 

Note: The 21 macros that are ccirmcn to the 
1401/1440/1460 and the 1410/7010 emulators 
should net be deleted when the system is to 
include a 1401/1440/1460 emulator. Delete 
only those macros that are unique to the 
1410/7010 emulator. 



RELOCATABLE LI BRAR Y 

J. ^ ^ 

I Number of | Number of Library Blocks | 
I Modules I (Physical Records) | 
^ 4 ^ 

1 I 25 I 237 I 

■ L . X-, J 



E.ANUM 

E.BDIL 

E.BIFLAG 

E.COMP 

E.DBIB 

E . DDTF 
E.PDUB 
E . DECCB 
E.DIIRCR 
E.DIL 

E.DSUB 
E.EMCNSL 
E.EMDISK 
E. EMEND. 
E.EMPNCH 

E.EMPTR 
E . EMRDR 
E.EMSOP 
E.EMTAPE 
E. EMULATOR 





Bytes of 


Module; Name 


Storage 


IIRBF 


250 


IIRGC 


1675 


IIRCP 


1547 


IIRDE 


772 


IIRDK 


4126 


IIRDL 


2236 


IIRDS 


656 


IIREJ 


290 


IIRFP 


2698 


IIRIS 


976 


IIRMI 


1160 


IIRMT 


629 


IIRMTP 


741 


IIRMW 


596 


IIRNT 


3292 


IIROA 


1706 


IIROB 


1538 
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IIRPOST 

IIRPR 

IIRPRE 

IIRSD 
IIRST 
IIRTP 
IIRUR 
IIRVT 



6073 

7083 

366 

366 

1943 

18U6 

3376 



Link-Edit Statements 



Tape Preprocessor Program 

PHASE phasename„*,NOAUTO 

INCLUDE IIRMTP 

INCLUDE IIRPRE 

ENTRY IIRPRE 
/♦ 

// LBLTYP TAPE 
// EXEC LNKEDT 



Transients 



$$BIIRED 
$$BIIRES 
$$BIIRMW 
$$BIIRSD 
$$EIIRT1 

$$BIIRT2 
$$BIIRT3 
$$BIIRT4 
§$BHRT5 
$$BIIRT6 



Phases 



IIROC 
IIROD 
IIROE 
IIROF 



Tape Postprocessor Program 

PHASE phasename, *,NOAUTO 

INCLUDE IIRMTP 

INCLUDE IIRPOST 

ENTRY IIRPOST 
/* 

// LBLTYP TAPE 
// EXEC LNKEDT 



IIROG 
IIROH 
IIROI 
IIROK 



Delete Statements 



Delete Statement 



DELETR IIR.ALL 



EELETC I IRC. ALL 
DELETC $$EIIRBD 
EELETC $$EIIRBS 
DELETC $$EIIRMW 



CORE IMAGE LIBRARY 

r T 1 

I Phases | Blocks | 
r + + — w^ 

I Transients | 10 f 11 | 
^ + + ^ 

I Phases I 8 I 16 I 
L J. i. J 



EELETC $$BIIRT6 



SAMPLE PROGRAM 



Z.EMSPIIO, Z.EMSPLIOS 
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SAMPLE PROGRAM SUMMARY: Figure 5-1 
illustrates the card deck that is punched 
when the sample program is retrieved from, 
the source statement library. 



Cards Retrieved 

CATALS Z.EMSPL10,t».0 
EKEND Z.EMSPLIO 

1400 object decks and source decks 
EKEND 

CATALS Z.EMSPLldS,a.O 
EKEND Z.EMSPLIOS 

1400 source deck 
EKEND 



The sample program lists 20 records on 
the printer. If a tape is available and 
assigned, the sample program writes out the 
records on tape. For a complete 
description of the sample programs, refer 
to the 1410/7010 Emulator manual. 



Figure 5-1. Sample Program Card Deck, 
1410/7010 Emulator 
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Module 6: Emulating the System/3@0 Model 20 on 
Models 115, 125, and 135 -5745-SC-E20 



Modular Outline 



Model 20 Eirulator under DOS/VS 280 

Fartiticn Size 280 

Delete Statements .....••• '280 

Relocatatle Library ........ .280 

Link-Edit Statements 280 

Delete Statements 281 

Core Image Library 281 

Delete Statements 281 

Data Interchange Function 281 

Partition Size 281 

Source Statement Library 281 

Macro 281 

Delete Statement 281 

Relocatable Library 281 

Link-Edit Statements 28 2 

Delete Statements 282 

Core Image Library 282 

Transients 282 

Phases 28 2 

Delete Statements 282 
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MODEL 20 EMUL?^TOR ONPEB pOS/VS 



The Model 20 Emulator Program consists of a 
group of macro instructions and object and 
load modules that are shipped in the source 
statement, relocatable, and core iirage 
libraries. An installation verificaticn 
program for postgeneration use is contained 
in the source statement library under the 
name Z.IISIVP20. In addition to the 
emulator, a data interchange function is 
supplied with the generation macro E.EMUDI. 



PARTITION SIZE 



DELETS E.IISEDB 



RELOCATABLE LIBRARY 



J. ,^^^ ^_^ ^ 

I Nuirber cf | Number cf Library Blocks | 
I Modules I (Physical Records) | 
^ + ^ 

I 27 I 195 I 

■ L X J 



XX bytes. For further information, refer 
to the Model 20 emulator publication. 

^ . ^ . ^ 

I Number of } Nuirber of { 
I Macros I Library Blocks | 
! } (Physical Records) j 
I- + ^ 

I I 22 I 2,222 I 

L . X — , J 

Macros 

E.EM1403 

E.EMm42 

E.EM20CHK 

E.EM20CONV 

E.EM20CPU 

E,EM20DI 

E.EM20END 

E.EM20MESS 

E.EM20PRHD 

E.EM20SYS 

E.EM20VRIF 

E.EM2152 

E.EM2203 

E.EM2311 

E.EM2U00 

E.EM2501 

E.EM2520 

E.EM2560 

E.IISCR 

E.IISDC 

E.IISEDB 

E.IVPEROC 



Module Name 

IISCM 

IISCMS 

xIov,F 

IISCPS 

IISDB 

IISDD 

IISDE 

IISDF 

IISDFED 

IISDI 

IISDK 
IISDI 
IISD2 
IISDB 
IISD4 

USED 

IISHC 

IISHFl 

IISHF2 

IISID 

IISIN 

IISMD2 

IISMF 

IISPD2 

IISTD 

IISTP 
IISTR 



Link-Edit Statements 



Delete Statements 



DELETS E.EM1103 
DELETS E.EMia42 
DELETS E.EM20CHK 



The ACTION CLEAR, PHASE, and 'INCLUDE 
Statements are generated automatically, in 
accordance with your specifications, when 
the E.EM20END macro is assembled. For more 
detailed information on the link~edit 
statements, refer to the Model 20 emulator 
publication. 
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Delete Statements 



DATA INTERCHANGE FUNCTION 



IIS is the identifier for both the basic 
Model 20 Emulator and the associated data 
interchange function. The statement 
DELETR IIS. ALL causes both the emulator and 
its data interchange function to be 
deleted. Unless this is desired, delete 
the modules one by one: 

DELETR IISCM 
DELETR IISCMS 



The Model 20 Data Interchange Function is 
generated as part of the Model 20 Emulator, 
under iracrc E.EMUDI. 



PARTITION SIZE 

For further information, refer to the Model 
20 emulator publication. 



SOURCE STATEMENT LIBRARY 



DELETR IISTR 



CORE IMAGE LIBRARY 

r T 1 

I Number of | Number of | 
I Transients j Library Blocks j 
I I (Physical Records) | 
I. -_-+ ^ 

I I 19 I 32 I 

L X J 



r T ~ 1 

I Number cf | Number cf | 
I Macros | Library Blocks j 
I I (Physical Records) | 

^ + ^ 

1 I 1 I 187 I 

L i J 



Macro 



Transients 

$$BIISAL 
$$BIISAS 
$$BIISA2 
$$BIISCC 
$$BIISCD 

$$BIISCF 
$$BIISCS 
$$BIISDI 
$$BIISDP 
$$BIISLE 

$$BIISM1 
$$BIISM2 
$$BIISM3 
$$BIISMt» 
$$BIISPR 

$$BIISRL 
$$BIISTD 
$$BIISTS 
$$BIISUR 



E.EMUDI 



Delete Statement 



DELETS E.EMUDI 



RELOCATABLE LIBRARY 

r • T T 

I Number cf | Number cf Library Blocks | 
I Modules ) (Physical Records) j 
f + _ ^ 

I I 1*5 I 300 I 

L X J 

M odul e Name 

IISCA 
IISDA 
USDS 
IISEC 
IISFl 



Delete statements 



DELETC $$BIISAL 
DELETC $$BIISAS 



DELETC $$BIISUR 



IISF2 
IISF3 
I IISFU 
IISIB 
IISIF 
IISILl 

IISIL2 

IISIL3 

I IISIL4 
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IISIRl 

IISIR2 

IISIR3 

I IISIRU 

IISMD 
IISMI 
IISML 
IISMO 
IISMR 

IISMS 
IISSMG 
IISSC 
IISSCI 

IISSCV 
IISSQ 
IISSl 
IISS2 
IISS3 
! IISS4 
IISTK 

IISTKC 

IISTKE 

IISTKI 

IISTl 

IIST2 

IIST3 
I IIST4 
IISVl 
IISV2 
IISV3 
I IISV4 



Link-Edit Statements 



The link-edit statements are generated 
automatically, in accordance with your 
specifications, when the E.EMUDI iracro is 
assembled. For more detailed information, 
refer to the Model 20 emulator publication. 



I DELETS IISVU 



CORE IMAGE LIBRARY 

r T 1 

I I Nuirter of | 
j I Library Blocks | 
I I (Physical Records) j 
^ «-«T 4 ^ 

I Transients | 6 | 8 | 

I ^ 4. 1 4 

I Phases I 7 | 7 | 

L X L J 



Transients 



$$BIISUC 
$$BIISUM 
$$EIISBI 
$$BIISBS 
$$EIISEX 
$$BIISFM 



Phases 



IISMTA 
IISMTB 
IISMTC 
IISMTD 
IISMTE 

IISMTF 
IISMTG 



Delete Statements 



Delete Statements 



IIS is the module identifier for both the 
Model 20 Emulator and the associated data 
interchange function. The statement 
DELETR IIS. ALL causes both the emulator and 
the data interchange function to be 
deleted. Data interchange modules must 
therefore be deleted individually: 

DELETS IISCA 
DELETS IISDA 



DELETC $$BIISUC 
DELETC $$EIISUM 



DELETC $$EIISFM 

DELETC IISMTA 
DELETC IISMTB 



DELETC IISMTG 
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Modular Outline 



Core Image Library 284 

Transients .284 

Relocatable Module Naming Conventions .285 

CDMOD 286 

DAMOD [28 9 

DIMOD . . , ! !29 

ISMOD ! .'290 

MTMOD ..!291 

System I/O Modules 292 

PRMOD , 293 

SDMOD ] [294 

Name List for Workfile Type Modules 

(TYPEFLE=WORK) 295 

System I/O Modules 295 

Required IOCS Modules 296 



ANS COBOL modules 






blocks, number of 


284 




modules , number of 


284 




CDMOD (card mqdules) 


285 




COBOL modules 






blocks, number of 


284 




modules, number of 


284 




DAMOD (direct access modules) 


289 




DIMOD (device indeperident modules) 


290 




ISMOD (index sequential modules) 


290 




macros, IBM-supplied 






CDMOD 


285- 


-288 


DAMOD 


285, 


,289 


DIMOD 


285. 


,290 


ISMOD 


285. 


,290 


MTMOD 


285, 


,291 


PRMOD 


285, 


,293 


SDMOD 


285 , 




magnetic tape module (MTMOD) 


291 




MTMOD (magnetic tape modules) 


291 





Modular Index 

naming conventions , relocatable 

modules 285 
PL/I (D) modules 

blocks, number of 284 

modules, number of 284 

printer modules (PRMOD) 29 3 
relocatable library 

blocks, number of 284 

modules, number of 284 
required IOCS modules 

blocks, number of 28 4 

real storage bytes 296 

modules, number of 284 

names 296 

SDMOD (sequential DASD modules) 29 4 

SDMODxx for workfile modules 295 

sequential DASD modules (SDMOD) 294 

systeiii I/O modules 296 

MTMOD 291 

SDMOD 294 
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r T 1 

I # TRANSIENTS | CIL BLOCKS | 
^ + ^ 

II 20 I 22 I 

u X J 



CORE IMAGE LIBRARY 
Transients 



$$BCBLIS 
$$BCBLOP 
$$BCBODA 
$$ECBUSR 
$$BCBUSW 

$$BCOBER 
$$EC0BR1 
$$EFCMUL 
$$EPL0SE 
$IJKSOO 

$IJKS10 
I^X JKo^ U 
$IJKS30 
$IJKS4 
$IJKS50 

$IJKS6 
$IJKS7 
$$BMU100 
$$EMU200 
$$EMU3 00 

Module 7 indicates the names of the preassembled modules shipped by IBM 
in the relocatable library, their sizes in bytes, their external storage 
requirements in library blocks, and the compilers that create linkage 
for their use. No IOCS modules are required fcr FORTRAN. An x in a 
column headed by a compiler indicates that the particular module may be 
linked by that compiler to the problem program. For exairple, an x in 
the columns headed by COBOL and PL/I indicates that COBOL and PL/I link 
the module so identified. Fcr assembler language prograirs, the user can 
preassemble IOCS modules as described in DOS/ VS Supervi sor and I/O 
Macros, GC33-5373. Note that separate modules are not assembled fcr 
DTFCN or DTFSR. 

The preassembled modules named in this module can be used by any 
other problem program whenever applicable. 



I Am. Nat. St. COBOL 

JAm. Nat. St. COBOL 6 COBOL 

I Am. Nat. St. COBOL fi PL/I 

JAm. Nat. St. COBOL,, COBOL 6 PL/I 

I COBOL 

I COBOL 6 PL/ 1 

I PL/I 

{Required IOCS Modules 

L ^^ 



Modules 


Blocks 1 


223 


1247 1 


132 


864 1 


158 


1053 1 


163 


970 1 


3m 


113U j 


77 


548 1 


107 


662 1 


70 


400 1 


27 


84 1 
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Note; Certain preassercbled IOCS ircdules are required when cataloging 
IBM components to the core iirage library. Do net delete these modules 
Erom the relocatable library until after all the IBM components you 
desire have been cataloged to the core image library. The ircdules are 
found in "Required IOCS Modules". 



Relocatable Module Naming Conventions 

Each module name begins with a 3-character prefix and consists of a 
5-character field corresponding to the option permitted in generation of 
the module. The following 3-character prefixes identify the 
preassembled IOCS modules shipped by IBM: 

IJC I/O Card (CDMOD) and 3 8 81 Optical Mark Reader 

IJD I/O Printer (PRMOD) 

IJF I/O Magnetic Tape (MTMOD) 

IJG Sequential Direct Access (SDMOD) 

IJH Index Sequential Direct Access (ISMOD) 

IJI Direct Access Method (DAMOD) 

IJJ Device Independent Access Method (DIMOD) 
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CDMOD 



CDMOD name = IJCabcde 

a = F RECFORM=FIXONB (always for INPUT and CMEND files) 

= U RECFORM=UNDEF 

= V RECFORM=VARUNB 

h = h CTLCHR=ASA (not specified CMBND) 

= C CONTROL=YES 

= Y CTLCHR=YES 

= Z neither CTLCHR nor CONTROL is specified 

C = B RDONLY=YES and TYPEFLE=CMBND 

= C TYPEFLE=CMBND 

= H RDONLY=YES and TYPEFLE=INPUT 

= I TYPEFLE=INPUT 

= N RDONLY=YES and TYPEFLE=OUTPUT 

= TYPEFLE=OUTPUT 

d = B WORKA=YES and I0AREA2=YES 

= I I0AREA2=YES 

= W WORKA=YES 

= Z neither WORKA nor I0AREA2 is specified 

(for CMBND files: WORKA is not specified) 

e = DEVICE=2540 or DEVICE=3881 

= 1 DEVICE=1442 or DEVICE=2596 

= 2 DEVICE=2520 

= 3 DEVICE=2501 

= 4 DEVICE=2540 and CRDERR is specified 

= 5 DEVICE=2520 and CRDERR is specified 

= 6 DEVICE=3505 

= 7 DEVICE=3525 and FUNC emitted, FUNC=R or FUNC=P 

= 8 DEVICE=2560 and FUNC omitted, FUNC=R or FUNC=P 

= 9 DEVICE=5425 and FUNC omitted, FUNC=R or FUNC=P 

= A DEVICE=3525 and FUNC=RP 

= B DEVICE=3525 and FUNC=RW 

= C DEVICE=3525 and FUNC=PW 

= D DEVICE=3525 and FUNC=I 

= E DEVICE=3525 and FUNC=RPW 

= F DEVICE=2560 and FUNC=RP 

= G DEVICE=2560 and FUNC=RW 

= H DEVICE=2560 and FUNC=PW 

= I DEVICE=2560 and FUNC=I 

= J DEVICE=2560 and FUNC=RPW 

= K DEVICE=5425 and FUNC=RP 

= L DEVICE=5U25 and FUNC=RW 

= M DEVICE=5425 and FUNC=PW 

= N DEVICE=5425 and FUNC=I 

= O DEVICE=5425 and FUNC=RPW 
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CDMOD 
Names 



COBOL PL/I 



Air. Nat. St. 
COBOL 



Bytes of 
Storage 



IJCFAOIO 






IJCFAOIl 


X 


X 


IJCFA0I2 


X 


X 


IJCFA0I4 


X 


X 


IJCFA0I5 


X 




IJCFAOZO 






IJCFAOZl 


X 


X 


IJCFA0Z2 




X 


IJCFAOZU 


X 


X 


IJCFA0Z5 


X 




IJCFCCZO 






IJCFCCZl 






IJCFCCZ2 






IJCFCIZO 






IJCFCIZl 






IJCFCIZ2 






IJCFYOIO 






IJCFYOIl 




X 


IJCFY0I2 




X 


IJCFYOm 




X 


IJCFYOZO 






IJCFYOZl 




X 


IJCFY0Z2 




X 


IJCFYOZU 




X 


IJCFZIIO 


X 


X 


IJCFZIIl 


X 


X 


IJCFZII2 


X 


X 


IJCFZII3 


X 


X 


IJCFZIZO 


X 


X 


IJCFZIZl 


X 


X 


IJCFZIZ2 


X 


X 


IJCFZIZ3 


X 


X 


IJCFZOIl 


X 


X 


IJCFZ0I2 




X 


IJCFZ0I4 


X 


X 


IJCFZ0I5 


X 




IJCFZOZl 


X 


X 


IJCFZ0Z2 




X 


IJCFZOZU 


X 


X 


IJCFZ0S5 


X 




IJCUAOIl 






IJCUAOIU 







116 
152 
156 
264 
248 
92 
128 



132 
248 
224 
218 
132 
218 
158 
132 
158 
96 



132 
136 
248 
72 
108 



112 
224 
136 
140 
136 



136 
104 
108 
104 
104 



116 
124 
232 
216 
74 



80 
208 
192 
164 
280 
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CDMOD 
Names 



IJCUA0I5 
IJCUAOZl 
IJCUAOZU 
IJCUA0Z5 
IJCUZOIl 

IJCUZOIU 
IJCUZ0I5 
IJCUZOZl 
IJCUZOZt* 
IJCUZ0Z5 

IJCVAOIl 
IJCVAOIU 
IJCVA0I5 
IJCVAOZl 
IJCVA0Z4 

IJCVA0Z5 
IJCVZOIl 
IJCVZOIU 
IJCVZ0I5 
IJCVZOZl 

ijcvzoz** 

IJCVZ0Z5 



COBOL 



PL/I 



Ait. 


Nat. St. 


Eytes of 


COBOL 


Storage 


X 




26t» 


X 




140 


X 




256 


X 




240 


X 




124 


X 




240 


X 




224 


X 




104 


X 




224 


X 




200 


X 




180 


X 




296 


X 




280 


X 




156 


X 




272 


X 




256 


X 




152 


X 




272 


X 




248 


X 




128 


X 




248 


X 




224 
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DAMOD 



DAMOD name = IJIabcde 



a = B 


RECFORM=UNDEF (handles 1 


DOth UNDEF a 


nd FIXUNB) 


= F 


RECFORM=FIXUNE 






= S 


RECFORM=SPNUNB 






= V 


RECFORM=VARUNB 






b = A 


AFTER=YES 






= Z 


AFTER is not specified 






C = E 


IDLOC=YES and FEOVD=YES 






= I 


IDLOC=YES 






= R 


FEOVD=YES 






= Z 


neither is specified 






d = H 


ERREXT=YES and RELTRK=YES 




= p 


ERREXT=YES 






= R 


RELTRK=YES 






= Z 


neither is specified 






e = W 


HOLD=YES and RDONLY=YES 






= X 


HOLD=YES 






= Y 


RDONLY=YES 






= Z 


neither is specified 






DAMOD 




Arr. Nat. St 


Bytes of 


Names 


COBOL PL/I 


COBOL 


Storage 


IJIEAIRZ 




X 


1632 


IJIBAIZZ 


X 


X 


1220 


IJIEAZRZ 




X 


1220 


IJIBAZZZ 


X 


X 


1012 


IJIEZIRZ 




X 


1U16 


IJIBZIZZ 


X 


X 


looa 


IJIBZZRZ 




X 


1004 


IJIBZZZZ 


X 


X 


796 


IJIFAIRZ 




X 


1532 


IJIFAIZZ 


X 


X 


1120 


IJIFAZRZ 




X 


1148 


IJIFAZZZ 


X X 


X 


940 


IJIFZIRZ 




X 


1228 


IJIFZIZZ 


X 


X 


816 


IJIFZZRZ 




X 


848 


IJIFZZZZ 


X X 


X 


636 


IJISAIRZ 




X 


3684 


IJISAIZZ 




X 


3640 


IJISAZRZ 




X 


3324 


IJISAZZZ 




X 


3324 


IJISZIRZ 




X 


2680 


IJISZIZZ 




X 




IJISZZRZ 




X 


2320 


IJISZZZZ 




X 


2320 



Module 7: Compiler IOCS Modules — 5745-SC-IOM 289 



DIMOD 



DIMOD name = IJJabcde 

a = F RECFORM=FIXUNB 

b = C always 

c = B TYPEFLE=OUTPOT (processes both input and output) 

= I TYPEFLE=INPUT 

d = I I0AREA2=YES 

= Z I0AREA2 is not specified 

e = C RDONLY=YES 

= D RDONLY is no t specified 



DIMOD 
Names 



PL/I 



Bytes of 
Storage 



IJJFCBID 
IJJFCBZD 
IJJFCIID 
IJJFCIZD 



1055 
903 
566 
454 



Note; See 
prefix. 



'Required IOCS Modules" before deleting modules with the IJJ 



ISMOD 



ISMOD name 



IJHabcde 



a = A RECFORM=BOTH and IOROUT=ADD or ADDRTR 

= B RECFORM=FIXBLK and IOROUT=ACD or ADDRTR 

= U RECFORM=FIXUNB and IOROUT=ADD or ADDRTR 

= Z RECFORM is not specified and IOROUT=LOAD or RETRVE 

b = A IOROUT=ADDRTR 

= I lOROUT-ADD 

= L IOROUT=LOAD 

= R IOROUT=RETRVE 

C = B TYPEFLE=RANSEQ 

= G I0AREA2=YES and TYPEFLE=SECNTL or IOROUT=LOAD 

= R TYPEFLE=RANDOM 

= S TYPEFLE=SEQNTL 

= Z neither is specified and IOROUT=LOAD or ADD 

d = B CORINDX=YES and HOLD=YES 

= C CORINDX=YES 

= HOLD=YES 

= Z neither specified 

e = F CORDATA=YES, ERREXT=YES, and RDONLY=YES 

= G CORDATA=YES and ERREXT=YES 

= CORDATA=YES and RDONLY=YES 

= P CORDATA=YES 

= S ERREXT=YES and RDONLY=YES 

= T ERREXT=YES 

= Y RDONLY=YES 

= Z nothing is specified 
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ISMOD 






Names 


COBOL 


PL/: 


IJHAABCP 






IJHAABCZ 






IJHAABZP 






IJHAABZZ 


X 




IJHAARCP 


X 


X 


IJHAARCZ 


X 


X 


IJHAARZP 


X 


X 


IJHAARZZ 


X 


X 


IJHAASZZ 


X 




IJHAIZZZ 


X 




IJHBABCP 






IJHEABCZ 






IJHEABZP 






IJHEABZZ 


X 




IJHBARCP 


X 


X 


IJHEARCZ 


X 


X 


IJHEARZP 




X 


IJHBARZZ 


X 


X 


IJHEASZZ 


X 




IJHEIZZZ 


X 




IJHUABCP 






IJHUABCZ 






IJHUABZP 






IJHUABZZ 


X 




IJHUARCP 


X 


X 


IJHUARCZ 


X 


X 


IJHUARZP 


X 


X 


IJHUARZZ 


X 


X 


IJHUASZZ 


X 




IJHUIZZZ 


X 




IJHZLZZZ 


X 


X 


IJHZRBCZ 


X 




IJHZRBZZ 


X 




IJHZRRCZ 


X 


X 


IJHZRRZZ 


X 


X 


IJHZRSZZ 


X 


X 



Air. 


Nat. 


St. 


Bytes of 


COBOL 




Storage 


X 








X 








X 






4802 


X 






4570 


X 






4198 


X 






4288 


X 






3916 



4090 
3196 
5208 
4836 
4930 

4558 
4326 
3950 
4048 
3672 

3844 
2950 
4940 
4624 
4658 

4342 
4058 
3738 
3776 
3456 

3630 
2736 
823 
2550 
2374 

166S 
1492 
1234 



MTMOD 



MTMOD name = IJFabcde 

a = F RECFORM=FIXUNB or FIXBLK 

= S RECFORM=SPNONE or SPNELK 

= U RECFORM=UNDEF 

= V RECFORM=VARUNB or VARELK 

= N RECFORM=UNDEF and ASCII=YES 

= R RECFORM=VARUNB or VARELK, and ASCII=YES 

= X RECFORM=FIXONB Or FIXELK, and ASCII =YES 

b = B READ=EACK 

= Z READ=FORWARD, or READ is not specified 
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c = C CKPTREC=YES 

= Z CKPTREC is not specified 

d = W WORKA=YES is specified 

= Z WORKA is not specified 

e = M ERREXT=YES and RDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

= Z neither is specified 



MTMOD 
Names 



COBOL 



PL/ 1 



Air. 


Nat. St. 


Bytes of 


COBOL 


Storage 






904 


X 




880 
784 


X 




784 


X 




688 


X 




2104 
696 
576 


X 




656 


X 




560 

1128 
1000 
1064 


X 




920 


X 




824 



IJFFBCZZ 
IJFFBZZN 
IJFFBZZZ 
IJFFZCZZ 
IJFFZZZZ 

IJFSZZWN 
IJFUBCZZ 
IJFUBZZZ 
IJFOZZZN 
IJFUZZZZ 

IJFVBCWZ 
IJFVBCZZ 
IJFVZCWZ 
IJFVZZZN 
IJFVZZZZ 



Name list for workfile type modules (TYPEFLE=WORK) 

MTMOD name = IJFabcde 

a = W always 

b = E ERROPT=YES 

= Z ERROPT is not specified 

C = N NOTEPNT=YES 

= S NOTEPNT=POINTS 

= Z NOTEPNT is not specified 

d = Z always 

e = M ERREXT=YES and RDONLY=YES 

= N ERREXT=YES 

= Y RDONLY=YES 

= Z neither is specified 



System I/O Modules 



IJFWEZZZ 
IJFWZNZZ 
IJFWZZZZ 



Note : See "Required IOCS Modules" before deleting modules with the IJF 
prefix. 
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PRMOD 



PRMOD name = IJDabcde 



= F RECFORM=FIXUNB 
= V RECFORM=VARUNB 
= U RECFORM=UNDEF 



b = A CTLCHR=ASA 

= Y CTLCHR=YES 

= C CONTROL=YES 

= S STLIST-YES 

= Z neither CTLCHR nor CONTROL nor STLIST is specified 

= U DEVICE=2560 

= V DEVICE=5425 



c = B ERROPT=YES (ERROPT=naire in DTFPR) and PRINTOV=YES 

= P PRINTOV=YES,, DEVICE is not a 3525, and ERROPT is not specified 

(ERROPT=RETRY or omitted in DTFPR) 

= I PRINTOV=YES, DEVICE=3525, and FUNC=W T cr oiritted 

= F PRINTOV=YES, DEVICE=3525, and FONC=RW T 

= C PRINTOV=YES, DEVICE=3525, and FUNC=PW T 

= D PRINTOV=YES,, DEVICE=3525, and FUNC=RPW T 

= Z neither ERROPT {ERROPT=RETRY or omitted in DTFPR) nor PRINTOV is 

specified, and DEVICE is not a 3525 

= PRINTOV=YES is not specified,, DEVICE=3525 and FUNC=W T or oiritted 

= R PRINTOV=YES is not specified,, DEVICE=3525 and FUNC=RW T 

= S PRINTOV=YES is not specified, DEVICE=3525 and FUNC=PW T 

= T PRINTOV=YES is not specified, DEVICE=3525 and FUNC=RPW T 

= E ERROPT=YES (ERROPT=naire in DTFPR) and PRINTCV=YES is not specified 

= U DEVICE=2560 or 5425 and FUNC=W or omitted 

= V DEVICE-2560 or 5425 and FUNC=RW 

= W DEVICE=2560 or 5U25 and FUNC=PW 

= X DEVICE=2560 or 5U25 and FUNC=RPW 



d = I 
= Z 

e = V 

= w 

= Y 

= Z 

PRMOD 
Names 



I0AREA2=YES 

I0AREA2 is not specified 

RDONLY=YES and WORKA=YES 

WORKA=YES 

RDONLY=YES 

neither is specified 



COBOL 



PL/I 



IJDFAPIZ 
IJDFAPZZ 
IJDFAZIZ 
IJDFAZZZ 
IJDFYPIZ 
IJDFYPZZ 

IJDFYZZZ 
IJDFZPIZ 

IJDFZPZZ 
IJDUAPIZ 
IJDUAPZZ 
IJDOYPIZ 
IJDUYPZZ 



Air. 


Nat. 


St. 


Bytes of 


COBOL 




Storage 


X 






280 


X 






268 
220 
196 


X 






152 


X 






mo 

96 
72 


X 






152 


X 






118 


X 






292 


X 






280 


X 






164 


X 






152 




Module 7: 


Compile 



Compiler IOCS Modules — 5745-SC-IOM 293 



IJDUZPIZ 
IJDUZPZZ 
IJDVAPIZ 
IJDVAPZZ 
IJDVYPIZ 
IJDVYPZZ 
IJDVZPIZ 
IJDVZPZZ 



16 
148 
312 
296 
184 
16 8 
188 
172 



SDMOD 



SDMODxx name = IJGabcde 



a = C 

= F 

= P 

= Q 

= R 

= S 

= u 

= V 

b = I 

= 

= u 



RECFORM= 
RECFORM= 
RECFORM= 
RECFORM= 
RECFORM: 
RECFORM= 
RECFORM= 
RECFORM= 

SDMODxI 
SDMODxO 
SbMODxU 



=FIXUNB or FIXBLK and HOLD=yES 

=FIXUNB or FIXBLK and HOLD is not specified 

:SPNONB or SPNBLK and HOLD=YES 

=SPNUNB or SPNBLK and HOLD is not specified 

=UNDEF and HOLD=YES 

=VARUNB or VARBLK and HOLD=YES 

:UNDEF and HOLD is not specified 

=VARONB or VARELK and HOLD is not specified 



c = C ERROPT=YES and ERREXT=YES 

= E ERROPT=YES 

= Z neither is specified 

d = M TRUNCS=YES and FEOVD=YES 

= T TRUNCS=YES 

= W FEOVD=YES 

= Z neither is specified 

e = B CONTROL=YES and RDONLY=YES 

= C CONTROL=YES 

= Y RDONLY=YES 

= Z neither is specified 



SDMOD 
Nantes 



COBOL 



PL/I 



Am. 


Nat. St. 


Bytes of 


COBOL 


Storage 






746 


X 




670 
614 
470 


X 




718 

630 

566 

1102 


X 




1054 

998 
834 


X 




1157 


X 




1113 


X 




2409 


X 




2317 


X 




2662 


X 




2598 


X 




685 



IJGFIETZ 
IJGFIEWZ 
IJGFIEZZ 
IJGFIZZZ 
IJGFOEWZ 
IJGFOEZZ 
IJGFOZZZ 
IJGFUETZ 
IJGFUEWZ 

IJGFUEZZ 
IJGFUZZZ 
IJGQIEWZ 
IJGQIEZZ 
IJGQOEWZ 
IJGQOEZZ 
IJGQOEWZ 
IJGQUEZZ 
IJGUIEWZ 
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IJGUIEZZ 


X 


IJGUIZZZ 


X 


IJGUOEWZ 




IJGUOEZZ 




IJGUOZZZ 


X 


IJGUUEWZ 




IJGUUEZZ 




IJGUUZZZ 


X 


IJGVIEWZ 




IJGVIEZZ 


X 


IJGVIZZZ 


X 


IJGVOEWZ 




IJGVOEZZ 




IJGVOZZZ 


X 


IJGVUEWZ 




IJGVUEZZ 
IJGVUZZZ 


X 



641 
5U1 
801 
721 
653 
1153 
1097 

949 

785 

741 

637 

1229 

1137 

1065 

1346 

1282 
1106 



NAME LIST FOR WORKFILE TYPE MODULES (TYPEFLE=WCRK) 

SDMODxx name = IJGabcde 

a = T SDMODW specifies HOLD=YES 

= W SDMODW does not specify HOLD=YES 

b = C ERROPT=YES and ERREXT=YES 

= E ERROPT=YES 

= Z neither is specified 

c = N NOTEPNT=YES 

= R NOTEPNT=POINTRW 

= Z NOTEPNT is no t specified 

d = C CONTROL=YES 

= Z CONTROL is not specified 

e = T RDONLY=YES and UPDATE=YES 

= U UPDATE=YES 

= Y RDONLY=YES 

= Z neither is specified 



System I/O Modules 



IJGWEZZU 
IJGWEZZZ 
IJGWZNZZ 
IJGWZRZZ 

No te : See "Required IOCS Modules" before deleting modules with the IJG 
prefix. 
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Required IOCS Modules 

The following preassembled IOCS ircdules are required when cataloging and/or 
link-editing IBM components to the core image library. 

Module Bytes of 

Names Storage 



IJFWEZZZ 280 

IJFWZN2Z 424 

IJFWZZZZ 232 

IJGFIETZ 746 

IJGWEZZU 86 8 

IJGWEZZZ 796 

IJGWZNZZ 902 

IJGWZRZZ 840 

IJJCPAIN 838 

IJJCPDV 750 

IJJCPDVl 694 

IJJCPDV 2 358 

IJJCPDO 854 

IJJCPDON 798 

IJJCPDl 718 

IJJCPDIN 762 

IJJCPD2 478 

IJJCPD3 350 

IJJCPV 34 3 

IJJCPVl 271 

IJJCPV2 6 8 



IJJCPO 389 

IJJCPON 317 

IJJCPl 311 

IJJCPIN 239 

IJJCP2 128 

IJJCP3 58 
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Modular Outline 



Source Statement Library 298 

File Definition Macros 298 

Storage Requirements 298 
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r T 1 

I Number of | Core Image | 

I Transients | Library Blocks | 

^ , + ^ 

I 8 I 9 I 

L J. J 

Tr ansient s 

$$BODACL 
$$BODAIN 
$$B0DAI1 
$$B0DA01 
$$B0DA02 
$$E0DA03 
$$E0DA04 
$$B0DAU1 



P ^ ^ 

I Number of | Source Stateirent | 
I Macros I Library Blocks | 
^ + ^ 

[ j 3 I l,08i| j 

L -. X J 



SOURCE STATEMENT LIBRARY 
File Definition Macros 



E.DAMOD 
E.DAMODV 
E . DTFDA 



STORAGE REQUIREMENTS : 

Figure 8-1 defines the storage requireirents for DAMOD. The following are 
the storage requirements for DTFDA. 

DTFDA (D efine The File: Direct- Access Device) Table Require ment s 

RECFORM=FIXUNB requires 205-225 bytes, depending upon imperative macros 
used in the DTF. 

VERIFY=YES requires 40-80 bytes, depending upon imperative macros used 
in the DTF. 

AFTER=YES requires 80 additional bytes. 



RECFORM=SPNUNB requires 282-378 bytes, depending upon the imperative macros 
used in the DTF. 

VERIFY=YES requires 64-72 additional bytes, depending upon the 
imperative macros used in the DTF. 

AFTER=YES requires 88 additional bytes. 
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RECFORM=UNDEF requires 265-285 bytes, depending upon the imperative macro 
used in the DTF. 

VERIFY=YES requires 40-80 additional bytes, depending upon the 
imperative macros used in the ETF. 

AFTER=YES requires 16 additional bytes. 



RECFORM=VARUNB requires 216-330 bytes, depending upon the imperative macros 
used in the DTF. 

VERIFY=YES requires 64-72 additional bytes, depending upon the 
imperative macros used in the DTF. 

AFTER=YES requires 88 additional bytes. 

Relative addressing increases the size of the DTF 60-8 bytes plus 8 bytes 
per extent. (See DOS/VS Supervisor and I/O Macros listed on the front 
cover of this manual.) 



DAMOD (Direct-Access Device Module) 

r- 



I Formatting 
Module 



r T T T 

AFTER III I 

and I II I 

IDLOC 1 RELTRK | HOLD | ERREXT | 

+U84 I +212 I +84 I +28 | 
4 4 -_4 ^ 



j j Basic j I 

I RECFORM= I Module | IDLOC | AFTER 

I FIXUNB I 636 | +180 | +304 
j. 4 4 4- 



I UNDEF I 796 | +208 | +216 

I VARUNB I 686 | +210 | +298 

I SPNUNB I 2320 | +316 | +1004 

u J. X X 



+426 I +208 I +88 | +28 | 

+508 I +226 I +84 | +34 j 

+1320 I I +104 I +32 I 

X i i J 



Notes; 

1. Basic Module includes coding tc handle either FIXUNE or UNDEF ^ 
records and the WRITEKY, READKEY, READID, WRITEID, SRCHM, VERIFY, 

and CONTROL functions. 

2. AFTER includes coding to create the file and to handle the RZERO 
option. 

3. IDLOC includes coding to return the record identifier to the user in 
a location he specifies. 

4. Specification of trailer label processing in the DTF increases the 
size of each module by 50 ± 20 bytes. 

5. RDONLY=YES changes the size of the module -50 to +50 bytes. In 
addition, the user's program must provide a 72-byte save area each 
time the module is reentered. 

6. RELTRK may be specified for SPNUNB records. This specification 
requires no additional bytes. 

Figure 8-1. DAMOD — Storage Requirements 
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Module 9: 3540 Diskette I/O Unit IOCS -5745-SC-DIO 



Modular Outline 



Core Image Library 302 

Transients 302 

Source Statement Library 302 

File Definition Macros 302 

Storage requirements 302 
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r ■ 

1 Librari 

L «, «.« 


es 




1 

J 


r — — ~ — T 

1 Core Image | 
^ ^ 4_ 

1 Transients 1 Blocks | 

L 1 L_ 


Source 
Macros 


1 

Statement | 

-T i 

1 Elocks 1 
— 1— J 


r — — — T — r 

1 20 1 20 1 

L JL J.- 


3 


T 

1 
_J._ 


492 1 

J 



CORE IMAGE LIBRARY 
Transients 



$$AEERR7 
$$B0DI01 
$$B0DI02 
$$B0DI03 
$$BODIOU 



$$B0DI05 
$$B0DI06 
$$B0DI07 
$$B0DI08 
$$BODMSG 

$$B0DMS2 
$$BODSMO 
$$BODSPO 
$$BODUCA 
$$B0PEN3 

$$BOVDMO 
$$BOWDMO 
$$B35U0I 
$$B3540O 
$$B35400 



SOURCE STATEMENT LIBRARY 
File Definition Macros 



E.DTFDU 

E.DUMODFI 

E.DUMODFO 



Storage requirements 

Figure 9-1 and 9-2 specify the storage required ty DTFDU and DUMOD. 
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DTFDy (Define The File Di skette Unit ) 

r TT -* 1 

I I I CMDCHN I 

I I ^ f 

I TYPEFLE II 1 2 13 26 j 
I INPUT I I 152 160 248 352 | 

I OUTPUT II 160 168 256 360 | 

L XX J 

Figure 9-1. DTFDU — Storage Requirements 
DUMOD (Diskette Unit MODule) 

r TT T T T T ^ T '1 

I Module I I Basic | RDONLY | ERROPT | ERROPT j ERROPT | ERROPT | 
I Name j | Module | | | RDCNLY | ERREXT | ERREXT j 

I II I I I I t RDONLY I 
j. ^^. 4 + 4 4 4 ^ 

I DUMODFI I I 788 j 776 j 868 | 848 | 924 | 902 | 
I DUMODFO I I 632 | 594 | 696 | 642 | 1078 | 1024 | 

L —.XX X X X X X J 

N ote : For RDONLY=YES, the user's program must provide a 72-byte save 
area each time the module is reentered. 

Figure 9-2. DUMOD — Main Storage Requirements 
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Module 10: Indexed Sequential Access Method -5745-SC-ISM 



Modular Outline 



Source Statement Library 306 

Macros 306 

File Definition 306 

Imperative 306 

Storage Requirements • 307 
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J. , . ^ ; ^ 

I Number of | Core Iirage | 

I Transients | Library Blocks | 
^ + ^ 

I 21 I 28 I 

L ± J 

Transients 

$$BCISOA 
$$BENDFF 
$$BENDFL 
$$BINDEX 
$$BOIS01 

$$BOIS02 
$$BOIS03 
$$BOIS04 
$$BOIS05 
$$BOIS06 

$$BOIS07 
$$BOIS08 
$$BOIS09 
$$B0RTV1 
$$B0RTV2 

$$BSETFF 

$$BSETFG 

$$BSETFH 

$$BSETFL 

$$ESETL 

$$BSETL1 



r T 1 

I Number of | Source Statement | 
I Macros | Library Blocks | 
^ + ^ 

I I 6 I 2242 I 

L X - J 



SOURCE STATEMENT LIBRARY 
Macros 

FILE DEFINITION 

E.DTFIS 
E.ISMOD 

IMPERATIVE 

E.ENDFL 
E.ESETL 
E.SETFL 
E.SETL 
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storage Requ ir em ent s 

Figure 10-1 defines the storage requirements for ISMOD. The storage 
requirements for DTFIS are: 

DTFIS ( Define The Fi le In dexed Sequential) Table Reguireirients : 

1. IOROUT=LOAD requires 248 bytes plus 4 bytes per disk extent 
specified, plus 8 bytes for I0AREA2. 

2. IOROUT=ADD requires 530 bytes plus H bytes per disk extent specified 
plus KL (the length of the key). 

3. IOROUT=RETRVE requires 276 bytes plus 4 bytes per disk extent 
specified, when TYPEFLE=SEQNTL. 

4. IOROUT=RETRVE requires 292 bytes plus U bytes per disk extent 
specified when TYPEFLE=RANDOM cr RANSEQ. 

5. IOROUT=ADDRTR requires 548 bytes plus 4 bytes per disk extent 
specified plus KL (the length of the key) . 

6. IOROUT=ADDRTR, TYPEFLE=RANDOM, INDAREA=nam€, and INDSIZE=n require 
572 bytes plus 4 bytes per disk extent. 



ISMOD (Indexed Sequential Module) 



I RECFORM= 

I FIXUNB 

I FIXBLK 

[BOTH 

S. 



LOAD 



IOROUT= 



ADD 



HOLD 



k- 



lERREXT II0AREA2 | ERREXT | jCORDATA |ERREXT |HOLD |CORDATA | CORDATA 

I I ^ ^ I I I ^ 4 

I I II0AREA2 II II I ERREXT | ERREXT 

III I II III I 

I I I 12608 1+184 1+476 |+194 |+660 | +854 

I I I I 2822 1+272 | + 498 |+186 |+770 |+956 

823 1+224 1+212 |+436 | 3068 | +246 |+428 |+210 |+674 | +884 | 



Figure 10-1. ISMOD Storage Requirements (Part 1 of 5) 
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IOROUT=RETRVE 



TYFEFLE= 



RANDOM 



SEQNTL 



RANSEQ 



RECFORM 
FIXUNB 



'T T 

I ERREXT I HOLD 

I I 

i I I 



ERREXT 



+ + 



I0AREA2 I HOLD 
I 



I 



ERREXT 

+ + 

+ i 



HOLD 



FIXBLK 



BOTH 



1304 I +302 I +156 I 1326 | +246 | +836 | +104 | 2186 | +332 | +236 

X JL X X X X X X X J 



Figure 10-1. ISMOD Storage Requirements (Part 2 of 5) 



IORCOT=ADDRTR 
TYPEFLE= 



RANDOM 



SEQNTL 



■T T T T T 

JCORDATA I ERREXT | CORDATA | HOLD | 
I I ^ ^ I 

I I I ERREXT I I 



CORDATA JI0AREA2 | HOLD j ERREXT 



RECFORM 



-+ 

1+386 



-+ 

1+278 



FIXUNB 



3252 1+320 



+ 534 



+718 



1+304 13502 1+94 



1+510 
4 

1+528 

■+ 

1+558 
.X 



FIXBLK 



3468 1+376 



1+554 1+826 



+304 13716 1+272 






BOTH 



3712 1+372 

X- 



+ 588 



+ 834 



1+320 13962 1+274 
.X X X. 



1+386 

+ 

+ 386 



1+278 
4 

1+294 
.X 






Figure 10-1. ISMOD Storage Requirements (Part 3 of 5) 



y- 



IOROUT=ADDRTR 



TYPEFLE=RANSEQ 
-T T T T 

I CORDATA I ERREXT | CORDATA | HOLD | 
I I |. ^ I 

-^ I I I ERREXT I I 
RECFORM= 
^ + + + + + ^ 

42661 +316 I +556 | +750 |+384| 

4494| +372 | +584 | +856 |+384| 

47261 +248 | +616 | +864 |+400| 
X X X X J 



Figure 10-1. ISMOD Storage Requirements (Part 4 of 5) 
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r 

Note 1: When RECFORM=BOTH is specified, the 
module processes FIXUNE and FIXBLK 
records. 

Note 2: For CORINDX = YES, add 212 bytes. 

Note 3: RDONLY=YES changes the ircdule size by 
±50 bytes with the following 
exceptions. When IOROUT=ADD or 
IOROUT=ADDRTR, the module changes in 
size +60 to +100 bytes. In addition, 
the user*s program must provide a 
7 2-byte save area each time the ircdule 
is reentered, regardless of function. 



Figure 10-1. ISMOD Storage Requirem-ents (Part 5 
of 5) 
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Module 11: Magnetic Character Reader IOCS .-5745-SC-MCR 



Modular Outline 



Core Image Library 312 

Transients 312 

Source Statement Library 312 

Macros 312 

File Definition 312 

Imperative 312 

Sample Problems 312 

Storage Requirements . 312 

Sample Problerrs 312 

Sample Problem Summary 312 
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T * 1 

I Libraries 1 

i. ^ ^ 

I Core Image 1 Source Statement ] 
y ^ ^-_+ ^ ^ 

I Transients I Blocks | Macros | Elocks | 
|. + + + ^ 

I 4 I 4 I 6 I 278 I 

L .-i. —X X J 



CORE IMAGE LIBRARY 



Samp le Pro klems 



iPhase 



JDisk Extent Number 
^ ^ ^-. 

|1 |2 |3 



^ + + + + J 

I ASSEMBLE |SYSLNK |SYS001 |SYS002 |SYS003 

I III 

ILINKEDIT ISYSLNK |SYS001 |- 

I III 

I EXECUTE |- |- |- 

L i X X 



Transients 



Figure 11-1. MICR — Sample Problem File 
Requirements 



$$AEERRS Error Recovery Procedure 
$$BCMR01 CLOSE 
$$BMMR20 Message Writer 
$$EOMR01 OPEN 



SOURCE STATEMENT LIBRARY 



Macros 



FILE DEFINITION 

E.DTFMR 
E.MRMOD 

IMPERATIVE 



I Cards Retrieved 
^ . 

JCATALS Z.MCRl 
jEKEND Z.MCRl 
|MCR1 Source Deck 
I (71 Cards) 
lEKEND 

I 

ICATALS Z.MCR2 

lEKEND Z.MCR2 

|MCR2 Source Deck 

j (115 Cards) 

lEKEND 

L 



Card Ccls. 
73-76 



$477 



$477 



T 1 

Card Ccls. 
77-80 



0001-0071 



0001-0115 



Figure 11-2. MICR — Sample Problem card 
Decks 



E.DISEN 
E.LITE 



SAMPLE PROBLEM SUMMARY 



SAMPLE PROBLEMS 

Z . MCRl 
Z.MCR2 

STORAGE REgUIREMENTS 

DTFMR (Def ine_The File Magnetic Character 
Reader) Table Requirements : 

If ADDRESS=DUAL is Specified, the table 
requires 264 bytes. 

If ADDRESS=DUAL is not specified, the table 
requires 250 bytes. 

MRMOD (Magnetic Character Reader Module) 

If ADDRESS=DUAL is specified, the module 
requires 1,050 bytes. 

If ADDRESS=DUAL is not specified, the 
module requires 946 bytes. 



Figure 11-1 defines the files required for 
the MICR sample problems. Figure 11-2 
shows the sample problem card decks 
retrieved from the source statement 
library. 

The first 1419 Magnetic Character Reader 
sample problem: processes 500 documents from 
one magnetic character reader using GET 
logic. The documents are read into pocket 
3 in groups of approximately 50. After 
each group is read, the 1419 Magnetic 
Character Reader is disengaged, the batch 
number is updated, ard the pccket light is 
turned on. All documents are listed on the 
printer. If the Selective Tape List 
feature is present on the printer, the 
documents are listed on the leftmost tape. 
The controls on the magnetic character 
reader that must be pressed, if present, 
are: BATCH NUMBER ON, PROG SORT, and at 
least one field for the VALIDITY CHECK AND 
READ OUT control. 
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The second 1419 Magnetic Character 
Reader sample problem processes 250 
documents from each of two iragnetic 
character readers (both of the same type: 
both with a single address adapter or both 
with a dual address adapter), using READ, 
CHECK and WAITF logic. The only controls 
that must be pressed are PROG SORT and at 
least one field for the VALIDITY CHECK AND 
READ OUT control. Documents from one 
reader are selected into pockets one or 
zero depending on whether or not the 
selected field is present. Documents read 
in error are rejected, and all data is 
listed on a printer. If the Selective Tape 
List feature is present on the printer, 
data is printed on the leftmost tape. 



Documents from the second reader are 
selected according to a digit in the field 
read and printed on SYSLST. If manual 
intervention is required on the second 
reader, a message is printed on SYSLOG. 
This message is: 

INTERVENTION REQUIRED ON FILE2. 

The program names are Z.MCRl and Z.MCR2, 
The 1419 sample problems support the 
1255/1259. 



Instructions show hew to reircve the 
following optional features: 

1. Dual addressing adapter feature 

2. Batch numbering 

3. Pocket lights 

4. Selective Tape List Feature (Printer) 

SYSLOG Output Is: 



EG // JOE NCR SAMPLE PROBLEMS 

BG // PAUSE END OF MCRl SAMPLE PROBLEM 

BG 

EG INTERVENTION REQUIRED ON FILE2 

BG ECJ MCR 

BG // PAUSE END OF MCR SAMPLE PROBLEMS 



SYSLST Output Summary : 

Job control cards 

External symbol dictionary 

Source program listing 

Relocation dictionary 

Linkage editor input diagnostics 

Linkage editor storage map 

Document data listings 
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Module 12: Magnetic Tape IOCS .-S745.SC.TAP 



Modular Outline 



Core Image Library 316 

Transients 316 

File Definition Macros 316 

Storage Requirements 316 

DTFMT (Define The File: Magnetic 

Tape) Table Requirements 316 

MTMOD (Magnetic Tape Module) . . . .318 
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r 1 

I Libraries | 

^ ^ ^ 

I Core Image | Source Statement | 

^ ^ 4 ^ 1 

I Transients I Blocks | Macros | Elocks | 
|. + + 4 ^ 

I I 18 I 32 I 2 I 973 | 



CORE IMAGE LIBRARY 
Transients 



$$BCE0V1 Monitor EOV/EOF 

$$BCMT01 Tape EOF/EOV input-f orward 

$$BCMT02 Tape CLOSE-alternate switching 

$$BCMT03 Tape CLOSE input-backward 

$$BCMTOU Tape E07 output-f crward 

$$BCMT05 Tape CLOSE 

$$BCMTQ6 Tape CLOSE-work files 

$$BCMT07 Tape-alternate switching 

$$BCMTOM Tape OPEN message 

$$BCMTOW Tape OPEN message 

$$BOMT01 Tape OPEN input-f crward-standard labels (Phase 1) 

$$BOMT02 Tape OPEN input-backward-standard labels 

$$BOMT03 Tape OPEN output forward-Standard label 

$$BOMT0'4 Tape OPEN output-Standard labels 

$$BOMT05 Tape OPEN I/O forward/backward ncnstandard/unlabeled 

$$BOMT06 Tape OPEN workfiles 

$$BOMT07 Tape OPEN input-f crward-standard labels (Phase 2) 

$$BONVOL Tape rewriting 



File Definition Macros 



E . DTFMT 
E . MTMOD 



STORAGE REQUIREMENTS 



Figures 12-1 and 12-2 define the storage requirements for DTFMT and MTMOD, 
DTFMT (Define The File; Magneti c Tape) Table Requirements 



TYPEFLE=WORK requires 48 bytes per workfile. 



The table requirements for INPUT and OUTPUT files are: 
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T T 

ERROPT, 
ERREXT 
(Without 
STDLABELS) 



T 1 

ERROPT, 

ERREXT 

(With 

STD LABELS) 



TYPEFLE= 



RECFORM 



Basic 
Size 
Without 
STDLABELS 



Basic 
Size 
With 
STDLABELS 



INPUT 



FIXUNB 

or 
FIXBLK 



96 



VARUNB 

or 
VARBLK 



109 



112 
128 



UNDEF 



92 



108 



SPNUNB 



132 



132 






OUTPUT 



86 



+ 10 



lOU 



+ U 



FIXUNB 

or 
FIXBLK 

VARUNB I 98 1 +10 

or 
VARBLK 

+4 



116 



+ U 



^ 



^ 



UNDEF 
SPNUNB 



84 
132 



100 
132 



+ 4 

* 



I X J. J._. 

* Included in basic Size of Module. 



Figure 12-1. DTFMT — Table Requireirents 
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MTMOD (Magnetic Tap e Module) 



EBCDIC MAGNETIC TAPE MODULE 



■TT- 
11 



4+- 



INDEPENDENT OPTIONS 



RECFORM= 



BASIC 
MODULE 






I FIXUNB/FIXBLK | | 688 

4+- 



I 

h 

I UNDEF 
J. 



WORKA= 
YES 



+ 80 



CKPHTEC= 
YES 



+ 112 



BEAD= 
BACK 



+ 96 



ERREXT 



+ 96 



VARUNB/VARBLK 



824 



+ 112 



+ 108 



+ 84 



+ 96 



II 

4+- 



560 



+ 80 



+120 



+ 16 



+ 96 



1808 



+ 260 



+300 



.XX. 



+ 252 

X J 



I SPNUNB/SPNBLK 
L 

Notes; 

1. Only one module is required for processing all files having a ccirircn 
RECFORM. This module can be generated with the options charted 
above. To determine the size of the module with the options, the 
number of option bytes specified in the chart must be added to the 
basic module. 

2. RDONLY=YES, changes the size of the module -50 to +50 bytes. In 
addition, the user's prograrr; must provide a 72-byte save area each 
time the module is reentered. 

Figure 12-2. MTMOD — Storage Table Requirements (Part 1 cf 3) 



WORKFILE MODULE 



TYPEFLE=WORK 



without 
NOTEPNT 



NOTEPNT= 
T 



^ +. 

I without ERROPT I 

l. +. 

I with ERROPT I 
I- 



YES 



POINTS 



232 
280 
436 



424 I 286 



540 



380 



I with ERROPT 6 | 
I ERREXT I 
L X 



654 I 494 

I 

X 



Figure 12-2. MTMOD — Storage Table Requirements (Part 2 of 3) 
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ASCII MAGNETIC TAPE MODULE 



■TT- 



RECFORM= 



BASIC 
MODULE 



INDEPENDENT OPTIONS 
T T— 



h 



H- 

I FIXUNB/FIXBLK j j 



WORKA= 
YES 



CKPRTEC= 
YES 



READ= 
BACK 



ERREXT 



824 



+ 92 



+128 I +120 



h 



-++- 



I VARUNB/VARBLK | | 968 



+ 112 






UNDEF 



656 



+ 80 



+ 56 
+ 8 



.XJL. 



I +96 

I +96 
.-J. 



Figure 12-2. MTMOD — Storage Requirements (Part 3 of 3) 
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Module 13: IBM 1287 Optical Character Reader IOCS 

-5745-SC-OCR 



Modular Outline 



Core Image Library 322 

Transients 322 

Source Statement Library 322 

Macros 322 

File Definition 322 

Imperative 322 

Storage Requirements 322 

ORMOD (Optical Reader Module 

— except for the 3 881 Optical Mark 

Reader) 322 

DTFOR (Define The File: 1287 

Optical Reader) Table Requirements . 322 

Sample Problem Summary ...... .323 
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Libraries 

T 

Core Image | Source Statement 
T. + T 

Transients j Blocks | Macros | Blocks 
+ + + 

2 I 2 I 5 I 712 

X X X 



Macros 



FIL E DEFINITION 

E.DTFOR 
E.ORMOD 

IMPERATIVE 



CORE IMAGE LIBRARY 
Transients 



E.DSPLY 
E.RDINE 
E.RESCN 



$$AEERRT Error Recovery Procedure 
$$BOOR01 OPEN 



SOURCE STATEMENT LIBRARY 



STORAGE REQUIREMENTS 



Figure lJ-1 defines the storage 
requirements for ORMOD. 



O RMOD ( Opt ical Rea d er Module — except for 
the 3881 Optical Mark Reader) 



f 


T' 




"XT 

il 
II 
II 


1 


INDEPENDENT 


OPTIONS 










1 






II 


T 


I0AREA2= 








1 IBasic 




CCNTROL= 




I0AREA2= 


= 1 


WCRKA= 1 


YES and 




DEVICE=| 


RECFORM= 


1 j Module 




YES 






YES 




YES 1 


WORK A= YES 


h 


+■ 


FIXUNB 


-++ 

1 1 892 


-+- 


+ 220 


-+- 


— — 


+ 76 


-+- 


+60 1 


+ 96 






FIXBLK 


li 1256 




+ 264 






+56 




+ 28 1 


+ 84 






UNDEF 


1 i 848 




+ 224 






+ 56 




+ 64 1 


+ 88 




1287T/ 1 


UNDEF 


II 
II 






















BLKFAC=YES 


II 1180 




+ 268 






+ 56 




+ 24 1 


+ 80 




1287D 1 




II 




















or 1 


FIXUNB 


II 1360 




+184 











1 







1288 1 


UNDEF 


II 1256 




+188 











1 






.XX. 



Figure 13-1, OPTICAL READER — ORMOD Storage Requirements 



DTFOR (Define The Fi le; 1287 Optical Reader) Table J Requirem.ent s 

1. RECFORM=FIXUNB requires 136 bytes. 

2. RECFORM=FIXBLK varies as a function of blocking- 

Size = 136 + (16 X blocking factor x number of I/O areas) 

3. RECFORM=UNDEF requires 136 bytes. 
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Sample Problem Summary 



The 1288 sample probleir is obtained by 
retrieving the sample probleir for the 1287 
journal tape mode of operation (Z.CRJT) and 
changing the cards with the sequence 
numbers 1058 and 1071 as follows: For both 
cards change the parameter DEVICE=12 87T to 
DEVICE=1287D. (Refer to the listing 
containing the source statements fcr the 
sample test program for journal tape 
processing) . Figure 13-2 illustrates the 
files used by both problems, and Figure 
13-3 illustrates the card decks that are 
punched when the sample problem is 
retrieved. 



The sample problem illustrating document 
processing for the 1287 or 1288 optical 
reader (Z.ORDC) reads documents for data 
input into an input area, and then prints 
this data on SYSLST. Whenever the 1287 or 
1288 document hopper empties, press 
end-of-file or replenish the stack. 



Any approved document type may be used 
because the reference mark and data field 
coordinates are entered at program 
execution time. However, the data field 
chosen to be read may not exceed six 
characters in length. 



Disk Extent Number 



^ 

I Phase 
f 



•T — 

|3 



14 



H 



lAssemtle |SYSLNK |SYS0C1 |SYS002 |SYS003| 
I Link Edit|SYSLNK |SYS001 |- |- | 
I Execute |- |- |- j- I 

I I ± J. L J 

Figure 13-2. OPTICAL READER — Sample 
Problem 



Cards Retrieved 



CATALS Z. CRDC 
BKEND Z.CRDC 
Document Node 
Source Deck (17 9 
Cards) 
EKEND 



CATALS Z.CRJT 
BKEND Z.CRJT 
Journal Tape Source 
Deck (81 Cards) 
EKEND 



Card Cols 
73-76 



$478 



$478 



Card Cols. 
77-80 



0001-0179 



1001-1081 



Figure 13-3. OPTICAL READER — Sample 
problem Card Deck 



Figure 13-U is a sample input document. 
The listing contains examples of keyed-in 
error corrections identified by comments. 



Note; When using this program on a 1288, 
remove the RESCN and DSPLY macro statements 
within sequence numbers 0091 and 0109. 



SYSLOG Output : 



// JOB OPTICAL READER SAMPLE PROBLEM 

EOJ OPTICAL 

// PAUSE END OF OPTICAL READER SAMPLE 

PROBLEM 



The sample problem illustrating journal 
tape mode processing for the 1287 optical 
reader reads undefined records from the 
1287 optical reader into a work area from 
two I/O areas, and then prints these 
records on SYSLST. 



Any journal tape with a maximum record 
size of 38 characters is suitable for this 



33iipl8 jt>i.Cbl€m. 



Figure 13-5 is a portion of a sample 
input journal tape. 



SYSLST Output Summ ary : 

• Job control cards 

• External symbol dictionary 

• Source program listing 

• Relocation dictionary 

• Linkage editor input diagnostics 

• Linkage editor storage map 

• List of fields read frcm: 

for document sample problem, or 
fcr journal tape sample problemi 
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/ 23 456 78 






MMk 


»w 




t 

D 

t 
o 












DKcamoN 


< 


■UANTITY nm NUMUt S«VKi NO. COM 

05 24680 357 98 

01 36925 468 1 

02 1 3579 205 24 
01 72546 763 63 

03 56384 120 57 
01 42679 ^31 76 

04 66392 1 17 33 

7 sut 

/ lOtAl 
TUC 

135 79 

ratMA 

021057 

Mv~y DM 


AMOUNT 




2500 

49 8 
349 

/29 

1 47 

995 

3960 














8578 
1 50 

8728 




Figure 13-4. 



OPTICAL READER — Sample Input 
Document for Dccunient Mode 
Processing 



OlS 


34 5 t 


7flRC 


1S3 


45b7 


fiROS 


S3A 


5(i7a 


RDIT 


3A 5 


li7aR 


15N 


Asy 


7flRD 


153 S 


5b7 


AROl 


534X 


liTfl 


R015 


345C 


TflR 


0153 


45bT 


flRQ 


1534 


5b7Z 


RQl 


534 5 


t7fl/ 


DIE 


345(i 


7aRC 


1S3 


45li7 


AROS 


S3< 


5Ei7a 


RDIT 


3< 5 


fc7flR 


015N 


4 5 Is 


7fiaa 


153S 


5b7 


AROl 


534 X 


bTfl 


Rai5 


3 4 5C 


761 


0153 


45(iT 


fli^a 


1534 


5b7Z 


<iai 


534 5 


Ii7fl/ 


015 


345Ii 


7flRC 


1S3 


45ti7 


fiROS 


S3< 


51.7a 


ROIT 


345 


li7aR 


015N 


4i[i 


7aR0 


153S 


5(i7 


AROl 


534X 


ti7a 


Rai5 


345C 


7flR 


0153 


45bT 


aRO 


1534 


5b7Z 


RDl 


5345 


l,7fl/ 



Figure 13-5. OPTICAL READER — Sarrple Input 
for Journal Tape Mode 
Processing 



32U DOS/VS System Generation 



Module 14: IBM 3886 Optical Character Reader IOCS 

-5745-SC-OCR 



Modular Outline 



Core Image Library 326 

Transients 326 

Source Statement Library 326 

DRMOD (3886 Optical Character 

Reader Module) 326 

Macros 326 

Storage Requirements 326 

DTFDR Table Requirements: 326 
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r 

I Libraries 

^ ^ 

I Core Image | Source Statement 
^ _ ^ _ + ^ 

I Transients I Blocks | Macros ] Blocks 
^ + 4 4 

I I 2 I 2 I 6 I 357 

L X X X 

CORE IMR,GE LIBRARY 
Transients 

$$AEERAN Error Recovery Procedure 
$$BCOR01 OPEN 

SOURCE STATEMENT LIBRARY 

DRMCD (3886 Optical Character Reader 
Module) 

Macros 

1 . Format Definition 

E.DFR 
E.DLINT 



E.DLINTIN (Inner macro, used only by the 
DLINT macro) 

2 • File Definiticn 

E . DTFDR 
E . DRMOD 

3 . Imperative 

E . SETDEV 

STORAGE RECUIREMENTS 
CRMOD: 

(Basic Size = MU3 bytes) 
Basic + RCCNLY=395 
Basic + SETDEV=773 
Basic + RDCNLY + SETDEV=773 



ETFDR Table Requirements: 



Size = 12U+BLKSIZE+FRSIZE 
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Module 15: Paper Tape IOCS -5745-SC-PTP 



Modular CXitline 



Core Image Library 328 

Transients 328 

Source Statement Library 32 8 

File Definition Macros 328 

Storage Requirements * ,328 

DTFPT (Define The File: Paper 

Tape) Table Requirements 328 

Input File 328 

Output File 328 

PTiyiOD (Paper Tape Module) 328 
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r 1 

I Libraries | 

^ ^ ^ 

I Core Image | Source Statement | 
|. ^ + ^ ^ 

I Transients I Blocks i Macros j Blocks | 
^ + + + ^ 

I 3 I 4 I 2 I 593 I 

L X L JL J 



CORE IMAGE LIBRARY 
Transients 



$$ABERRU Error Recovery Procedure (ERP) 

$$AEERRV ERP 

$$BERPTP ERP - 1018 with error 

correction feature 



DTFPT (Define The Fi le; Pap er Ta^p e) Table 
Requirements 



INPUT FILE 

The possible table specif icaticns and sizes 
are: 

1. No translations, no shifts, and no 
deletes require 72 bytes. 

2. TRANS=name with no shifts and no 
deletes requires 76 bytes. 

3. TRANS=name, SCAN=name, RECFORM=FIXUNB 
require 110 bytes. 

4. TRANS=name, SCAN=name, RECFORM=UNDEF 
require 94 bytes. 

OUTPUT FILE 

The possible table specifications and sizes 
are: 



SOURCE STATEMENT LIBRARY 
File Definition Macros 



1. No shifts require 69 bytes. 

2. Shifts require 83 bytes. 



E. DTFPT 
E.PTMOD 



PTMOD (Paper Tape Module) 



STORAGE REQUIREMENTS 



The module specificaticns and sizes are 
specified in Figure 15-1. 



1 INPUT 1 OUTPUT 
^ ^ + 

1 2671 1 1017 1 1018 

l_ ± L ^ 


_ 1._ ^ 1. ^ 

1. No parameters specified (no | 244 | 2 88 | 
translation, no shifts and no | | | 
deletes) | | | 

+ + 1 

2. TRANS=YES with no shifts and | 310 | 354 | 
no deletes | | | 

+ 4. + 

3. TRANS=YES, SCAN=YES, | 536 | 570 | 
RECFORM=FIXUNB | | | 

+ + 4. 

4. TRANS=YES, SCAN=YES, ] 43 6 | 474 | 
RECFORM=UNDEF j | | 

+ + + 

5. No Shifts 1 1 1 352 
4 + 4 

6. Shifts 1 1 1 570 



Note: If module 2 is used, all records 
require translation. 

Figure 15-1. PTMOD — Storage Requirements 
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Module 16: Sequential Disk IOCS -8745-SC-DSK 



Modular Outline 



Core Image Library . .33 

Source Statement Library 33 

File Definition Macros 33 

Storage Requirements 33 

DTFSD (Define The File: Sequential 

DASD) 331 

SDMOD (Sequential DASD MODule) . . .332 
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r " 

I Libraries 

|. ^ 

I Core Image | Source Statement 
^ T- 4 T. 

I Transients I Blocks | Macros | Blocks 
^ + 4 4 

I I 22 I 22 I 11 I 5363 

■ L X X JL 



CORE IMAGE LIBRARY 

Transients 

$$B0SDC1 
$$B0SDC2 
$$BOSDEV 
$$B0SDI1 
$$B0SDI2 

$$B0SDI3 
$$B0SDI4 
$$B0SD01 
$$B0SD02 
$$B0SD03 

$$BOSDOU 
$$B0SD05 
$$B0SD06 
$$BCSD07 
$$B0SD08 

$$B0SD09 
$$B0SDW1 
$$BCSDW2 
$$B0SDW3 
$$BOSD00 

$$BOSD01 
$$B02321 



SOURCE STATEMENT LIBRARY 



File Definition Macros 



E.DTFSD 
E.SDMODFI 
E . SDMODFO 
E.SDMODFU 
E.SDMODUI 

E.SDMODUO 
E.SDMODUU 
E.SDMODVI 
E.SDMODVO 
E.SDMODVU 
E.SDMODW 
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STORAGE REQUIREMENTS 

Figures 16-1 and 16.2 specify the storage required by DTFSD and SDMOD. 



DTFSD (Define The File; Sequential DASD) 



•TT- 



TYPEFLE 



Ih 



RECFORM= 



I ^ 

I I with 
I I UPDATE 

•H 



INPUT 
-T 



OUTPUT! 



\- 



without 
UPDATE 



with 
UPDATE 



WORK 
— T- 



without 
UPDATE 



CONTROL 
YES 



FIXBLK 

or 
FIXUNB 

VARBLK 

or 
VARUNB 

SPNBLK 

or 
SPNUNB 



Y- 



II 176 
-++ 

II 
II 
I I 192 

-++ 

I I 240 



-++■ 



152 



160 



152 



152 



+ 24 






152 
188 



+ 



170 
+ 

244 






+ 24 
+ 24 



UNDEF 



II 192 I 152 I 162 I 152 | 152 
.J.X X X i. X 



+ 24 



Figure 16-1. DTFSD — Storage Requirements 
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SDMOD (SEQUENTIAL DASD MODULE) 



TT T- 

II I 

Module Name I I Basic Module | TRUNCS 






SDMODFI 






II 



t»62 



+ 8C 



SDMODFO 



516 



I +136 



I- H + 

JSDMODFU 11 798 j +81 

SDMODUI II 533 
I" 

I < 

h 
I < 



CONTROL 



+ 28 



+ 28 



ERROPT 



+ 1U£| 



+ 64 



HOLD 



ERRCPl 
ERREXT 



+ 228 



+ 200 



RECFORM=SPNELK 
RECFORM=SPNUNB 



+ 28 
+ 28 






+ 164 
+ 100 



+ 96 

* 



+ 252 

4 

+171 






■++■ 



SDMODOO 



653 



+ 28 



+ 68 



+ 116 



4+- 

II 



SDMODUU 



941 



+ 28 



+ 148 



+ 40 



+ 248 



-++■ 

II 
■++- 



SDMODVI 



729 



+ 28 



+104 



+ 188 



300-400 
1050-1150 
1500 



SDMOD VO II 1045 | 
SDMODVU I I 1086 | 



+ 28 

+ 

+ 28 



+ 68 
+176 



+ + _+ 



* 
+ 76 



+120 
+ 296 






-++- 



SDMODW 



II 
.XX. 



572 



+ 22 



+148 



+10 I +246 

X X 



L XX X X X X 

♦The HOLD function does not apply to these rncdules. 
Not es : 

1. For SDMODW, NOTEPNT=YES requires 2 06 additional bytes: NOTEPN'r=FOINTRVi 
requires 144 additional bytes, UPDATE=YES requires 40 additional bytes. 

2. RDONLY=YES changes the size of the module -50 to +50 bytes. In 
addition, the user's program must provide a 72-byte save area each time 
the module is reentered. 

Figure 16-2. SDMOD — Storage Requirements 
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Module 17: VSAM 



Modular Outline 



Core Image Library 334 

Transients 334 

Phases 334 

Relocatable Library 335 

Transients 335 

Source Statement Library 337 

Macros (Edited) 337 

VSAM Storage Requirements 337 

Virtual Storage 337 

VSAM 337 

ISAM Interface Program ,338 

Accesa Method Services 338 

Minimum Real Storage 338.1 
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VSAM INDEPENDENT COMPONENT RELEASE 



CORE IMAGE LIBRARY 



J. ^. 

I VSAM I 



AMS 



Transients 


1 


13 


1 


~~: 


Blocks 


1 


14 


1 


- 


Phases 


1 


23 


1 


65 


Blocks 


1 


20 6 


1 

-J. 


232 



Transients 



$$ECVSAM 
$$ECVS02 
$$BCVS03 
$$BCVS04 

$$BJIBFF 
$$BJIBOO 
$$BOCISC 
$$BODADE 
$$BODADS 

$$BOVSAM 
$$BOVS01 
$$BOVS03 
$$BTCLOS 



Phases 



IDCALOl 

IDCAMS 

IDCCDAL 

IDCCDDE 

IDCCDDL 

IDCCDLC 
IDCCDMP 
IDCCDPM 
IDCCDPR 
IDCCDRP 
IDCCDVY 

IDCCDXP 
IDCBBOl 
IDCDB02 
IDCDEOl 
IDCDIOl 

IDCDI02 
IDCDI03 



IDCDI04 
IDCDI05 
IDCDI06 



IBCDI07 
IDCDI08 
IDCDI09 
IDCDIIO 
IDCDIll 



IDCDI12 
IDCDI13 
IDCDI14 
IDCDI15 
IDCDLOl 

IDCEX02 
IDCEX03 
IDCIO02 
IDCIC03 
IDCLCOl 

IDCMPOl 
IDCPMOl 
IDCPROl 
IDCRIKT 
IDCRILT 

IDCRIOI 
IDCRI02 
IDCRI03 
IDCRPOl 
IDCSAOU 

IDCSA05 

IDCTP04 

IDCTP05 

IDCTSALO 

IDCTSDEO 

IDCTSDLO 

IDCTSEXO 

IDCTSIOO 

IDCTSLCO 

IDCTSLCl 

IDCTSMPO 

IDCTSPRO 
IDCTSRIO 
IDCTSTPO 
IDCTSTPl 
IDCTSUVO 

IDCTSXPO 

IDCVYOl 

IDCXPOl 

IIPAMDTF 

IIPCLOSE 

IIPOPEN 
IIPPROC 
IKQVCAT* 
IKQVCLC* 
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IKQVCLOS* 

IKOVDCN 

IKQVDNT* 

IKQVDUMP 

IKQVEDX* 



IKQVEOV* 

IKQVGEN* 

IKQVJIBS* 

IKQVLAB* 

IKQVLASF 



IKQVLASM* 

IKQVNEX* 

IKQVOPEN* 

IKQVPBF* 

IKQVRBA* 

IKQVRM* 

IKQVTMS* 



* These VSAM modules can run in the SVA, 
Note that Access Method Services and some 
VSAM modules cannot run in the SVA. 



RELOCATABLE LIBRARY 



i Number of 1 Number of j 
I Modules I Blocks | 
^ + ^ 

I 201 i 2052 I 

L X J 



Transients 



$$BCVSAM 
$$BCVS02 
$$BCVS03 
$$BCVS04 

^^RJIBFF 
$$BJIBOO 
IIPBMROO 
$$EODADE 
$$BODADS 

$$BOVSAM 
$$BOVS01 
$$BOVS03 
$$BTCLOS 



Modules 



IDCALOl 
IDCCDAL 
IDCCDDE 
IDCCDDL 
IDCCDLC 

IDCCDMP 
IDCCDPM 
IDCCDPR 
IDCCDRP 
IDCCDVY 

IDCCDXP 
IDCCMZl 
IDCCMZ2 
IDCDBOl 
IDCDE02 

IDCDEOl 
IDCDIOl 
IDCDI02 
IDCDI03 
IDCDI04 

IDCDI05 
IDCDI06 
IDCDI07 
IDCDI08 
IDCDI09 

IDCDIIO 
IDCDIll 
IDCDI12 
IDCDI13 
IDCDI14 

IDCDI15 
IDCDLOl 
IDCEXOl 
IDCEX02 
IDCEX03 

IDCICOl 
IDCIO02 
IDCIO03 
IDCLCOl 
IDCMPOl 

IDCPMOl 
IDCPROl 
IDCRIKT 
IDCRILT 
IDCRIOI 

IDCRI02 
IDCRI03 
IDCRPOl 
IDCSAOl 
IDCSA02 

IDCSA03 
IDCSA05 
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IDCTPOl 
IDCTPOU 
IDCTP05 



IDCTSALO 
IDCTSDEO 
IDCTSDLO 
IDCTSEXO 
IDCTSIOO 



IDCTSLCO 
IDCTSLCl 
IDCTSMPO 
IDCTSPRO 
IDCTSRIO 

IDCTSPO 

IDCTSTPl 

IDCTSOVO 

IDCTSXPO 

IDCVYOl 

IDCXPOl 

IGGOCLAB 

IGGOCLAC 

IGGOCLAD 

IGGOCLAE 

IGGOCLAF 
IGGOCLAG 
IGGOCLAH 
IGGOCLAJ 
IGGOCLAK 

IGGOCLAL 
IGGOCLAN 
IGGOCLAP 
IGGOCLAQ 
IGGOCLAR 

IGGOCLAS 
IGGOCLAT 
IGGOCLAU 
IGGOCLAV 
IGGOCLAW 

IGGOCLAX 
IGGOCLAY 
IGGOCLAZ 
IGG0CLA6 
IGG0CLA7 

IGGOCLAS 
IGGOCLBA 
IGGOCLBB 
IGGOCLBC 
IGGOCLBD 

IGGOCLBE 
IGGOCLBF 
IGGOCLBG 
IGGOCLBH 



IGGOCLBM 
IGGOCLBN 
IGGOCLBQ 
IGGOCLBR 
IGGOCLBS 

IGGOCLBT 
IGGOCLBU 
IGGOCLBW 
IG60CLBX 
IGGOCLBY 

IGGOCLBS 
IGG0CLC9 
IIPAMTOO 
IIPBMROO 
IIPCLSOO 

IIPIIPOO 
IIPOPNOO 
IIPPRCMR 
IIPPRCPR 
IKQALLOO 

IKQBFA 
IKQBLD 
IKQCAS 
IKQCIS 
IKQCLCAT 

IKCCLEAN 

IKQCLO 

IKCCOVOO 

IKQDCN 

IKQDNT 

IKQDTLC 

IKQDUMP 

IKQDDMPC 

IKQEDX 

IKQEOV 

IKQERH 
IKQERX 
IKQGEN 
IKQGNX 
IKQGPT 

IKgiCA 
IKQIOB 
IKCIXE 
IKQIXF 
IKQIXS 

IKQJIBSM 

IKQKRD 

IKQLAB 

IKQLASFT 

IKQLASMD 

IKQLCD 
IKCLCN 
IKQMDY 
IKQNCA 
IKQNEX 
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IKQOPN 

IKQOPNCT 

IKQOPNDO 

IKQOPNHC 

IKQOPNOV 

IKQPBF 

IKQPFO 

IKQPOPOO 

IKQRBA 

IKQRCL 

IKQRDSOO 

IKQRENOO 

IKQRQA 

IKQRQB 

IKQRTV 

IKQSCN 

IKQSCROO 

IKQSFT 

IKQSPM 

IKQSRT 

IKQTMS 
IKQUPD 
IKQVFY 
IKQVSM 
IKQVSMLK 

IKQVTCOO 
IKQWDSOO 
IKQZAP 



SOURCE STATEMENT LIBRARY 



r T 1 

I Number of | Number of | 
I Macros I Blocks j 
y + ^ 

I 14 1 1399 I 
L X J 



Macros (Edited) 



ACE 

ENDREO 

ERASE 

EXLST 

GENCB 



IKQCBl 

IKQCB2 

IKQERMAC 

MODCB 

POINT 

RPL 



SHOWCB 
TCLOSE 
TESTCB 



VSAM STORAGE REQUIREMENTS 



VIRTUAI STORAGE 

Virtual storage must be obtained net only 
for VSAM phases and work areas, but for its 
utilities (Access Method Ser^;ices) and, if 
required, the ISAM Interface Program. VSAM 
routines reside in pageable virtual 
storage. A recoromendable approach to 
allocating storage would be to allocate 
2U0K bytes in any partition in which VSAM 
will be executing. This basic allocation 
would also cover any requirement caused 
when ISAM Interface Program phases are 
loaded when a VSAM file is processed by an 
ISAM program. 

In addition to the 240K-byte basic 
allocation, an additional BOOK bytes should 
be allocated in any partition in which 
Access Method Services will be executing. 
Note that if VSAM runs in the SVA, only 50K 
bytes must be allocated in the partition. 



VSAM 



The following VSAM phases are leaded into 
virtual storage when a VSAM file is opened: 



J. ^ 

1 


r r- 

1 




1 

1 Function 

1 J 


1 
Phase ISize (bytes) 


r — 1 

1 Record management 

1 routines 
1 


IKQVRM 1 

1 
1 


25,300 


1 

|Open routines 

1 


1 

IKQVOPENI 
1 


10,800 


1 

1 Close routines 
1 


IKQVCLOS 1 
1 


3,500 


1 

jLabel processing 

1 routines 
1 


1 

IKQVLAB 1 

1 
1 


1,300 


1 

iCataloa routines 

i 
1 


1 

IKOVCAT j 

IKQVDCN j 

1 


120.600 


1 

|File table routines 

i 
1 


IKQVLASM 1 
IKQVLASF 1 
h 

1 


1,500 


1 TOTAL 


163,000 



When certain other conditions are 
encountered in VSAM processing, other 
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phases will be loaded into virtual storage. 
These phases remain in virtual storage with 
the originally loaded phases until the job 
step is ended. The following additional 
phases can be loaded: 



Condition 



I/O forced to completion 
(during Close, for 
example) 

Shared option U used and 
(1) a control area must 
be split or (2) the file 
is extended 

A new extent is needed 
when file is extended 

GENCB macro is used by 
the processing program 

MODCB, SHOWCB, or TESTCB 
macro is used by the 
processing program 

A non-contiguous range 
of RBAs is encountered 

Non-VSAM file entry in 
VSAM catalog is 
processed 

A new volume must be 
mounted 

DASD file protection 
option is included 
in DOS/VS system 

VSAM Close or Record 
Management routines must 
update the VSAM catalog 

Programmer specifies 
that VSAM control blocks 
are to be dumped 

Programmer specifies 
that VSAM phases in the 
Core Image Library are 
to be changed 

Programmer requests VTOC 
cleanup and scratching 
of protected VSAM files 

TOTAL 



Phase 



IKQVPBF 
IKQVRBA 

IKCVNEX 
IKQVGEN 
IKQVTMS 

IKCVEDX 
IKQVDNT 

IKQVEOV 
IKQVJIBS 

IKCVCLC 

IKQVDDMP 

IKQZAP 

IKQSCR 



Size 
(bytes) 



700 
1,000 

3,400 
2,100 
2,100 

2,200 
400 

1,200 
1,100 

2,200 

7,500 

4,500 

18,000 



In addition, virtual storage must be 
provided fcr buffers and ccntrcl blocks 
obtained by the phases mentioned above. 



The user should allcw apprcxiirately 50K 
bytes for VSAM buffers and control blocks. 
The control block requirements depend 
primarily en the number of files to be open 
in the partition. The minimum amount of 
buffer space allowed for a file is found in 
the VSAM catalog. The user can allocate 
more than the minimum buffer space when a 
file is processed (see DOS/VS Supervisor 

and I/O Macros). Note that phases IKQSCR, 

IKQVDUMP, and IKQZAP are requested 
separately by the programmer and cannot run 
in the SVA. If these phases are leaded, up 
to 30K additional storage will be required 
in the user's partition. 



ISAM^_ Interface^ Program 



When a VSAM file is processed by an ISAM 
program, the ISAM Interface phases are 
loaded intc virtual storage along with the 
VSAM phases. The following ISAM Interface 
phases are loaded when the ISAM program is 
opened: 



I Function 



|Open routines 

I 

I Processing routines 

I 

[Close routines 

I 

I ISAM Interface DTP 

I 

I TOTAL 



.^ . ^ ^ 

[Phase [Size (bytes)) 
^ 



IIPOPEN I 

I 

IIPPROC I 

! 

IIPCIOSEj 

I 

IIPAMDTFI 

I 

L J,. 



800 I 

I 
3,300 I 

I 
500 I 

I 
200 I 

H 



4,800 



^ ^ 

|46,400 I 
.X J 



Access Method Services 



Access Method Services requires up to BOOK 
bytes of virtual storage. 
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MINIMUM REAL STORAGE 



To avoid excessive paging, enough real 
storage should be available for VSAM 
buffers, control blocks, and frequently 
used control sections of phase IKQVRM. The 
recommended minimum amount of real storage 
is: 



VSAM routines* 
Buffers 
Control blocks 

Total 



13,550 bytes 

3,050 bytes 

750 bytes 

17,350 bytes 



* VSAM routines include the following 
modules of phase IKQVRM: 



IKQBLD 

IKQBFAOO 

IKQEFBOO 

IKQGPT 

IKQIOAOO 

IKCIOBOO 

IKQIXSOO 

IKQKRD 

IKQLCD 

IKCLCN 

IKQMDY 
IKQRCA 
IKCRTV 
IKQSCN 
IKQSRT 
IKQUPD 
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Module 18: Assembler -5745-SC-ASM 



Modular Outline 



Core Image Library 34 

Phases .34 

Relocatable library 34 

Modules 340 

Link-Edit Statements ....... .340 

Link-Edit Statements 341 

Source Statement Library 341 

Workfiles 341 
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CORE IMAGE LIBRARY 



Modules 



Phase I Blocks | 





— ■y— - 




"T 


— — «. — 


Assembler 


1 
4.— 


19 


1 


120 


ESERV 


1 
i 


7 


1 


40 



Phases 



Assembler 

ASSECA 
ASSEDA 
ASSEEA 

ASSEFA 
ASSEGA 
ASSEHA 
ASSEIA 
ASSEJA 

ASSEKA 

ASSELA 

ASSEMA 

ASSEMBLY 

ASSEOA 

ASSEQA 

ASSERA 
ASSERB 
ASSERC 
ASSESA 
ASSETA 

ESERV 

ESERV 

ESERVB 

ESERVD 

ESERVE 

ESERVF 

ESERVG 
ESERVI 



Assembler 

IPKAA 
IPKAE 
IPKAC 
IPKAD 

IPKAE 
IPKAF 
IPKAG 
IPKAH 
IPKAI 

IPKAJ 
IPKBA 
IPKCA 
IPKCB 
IPKCC 

IPKCD 
IPKDA 
IPKDB 
IPKEA 
IPKFA 

IPKGA 
IPKHA 
IPKIA 
IPKIC 
IPKJA 

IPKKA 

IPKLA 

IPKLINK 

IPKMA 

IPKNA 

IPKOA 

IPKPA 
IPKQA 
IPKRA 
IPKRB 
IPKRC 

IPKSA 
IPKSB 
IPKTA 



RELgCATABLE_LIBRARY 

r T T 1 

I I Modules I Blocks | 
|. __+ 4 ^ 

I Assembler | 38 | 605 | 
|. 4 1 4 

I ESERV I 10 I 213 I 
L X J. J 



link-Edit Statements 



INCLUDE IPKLINK 

// EXEC LNKEDT 

ESERV 

IPKESERV 

IPKVA 

IPKVB 
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IPKVD 
IPKVE 

IPKVF 
IPKVG 
IPKVI 
IPKVK 
IPKVM 



Link-Edit Statements 



INCLUDE IPKESERV 
/* 
// EXEC LNKEDT 

Note: When link-editing the ESERV program, 
the Link-Edit Map will contain one 
unresolved address constant (IPKAE103) . 
This is a symbol used in the Assembler 
only. 



SOURCE STATEMENT LIBRARY 



Number of 
Macros 



Source Statement 
Library Blocks 



4U 



Macros 

E.IVPASLC 
E.IVPASLS 



Workfiles 



To determine the number of bytes required 
for the assembler workfiles, use the 
following formulas: 



SYSOOl: Whichever is the larger of 

60(ITXT+SM) 

and 

60(SM+LM) 

SYS002: Whichever is the larger of 

60 (ITXT + SM) 

and 

UO.ETXT 

SYS003: If option NOXREF is in effect: 

60.OTXT 

If option XREF is in effect: 

lOO.OTXT 

SYSLNK: 15.ETXT 

where 

ITXT = Total number of statements on 
SYSIPT. 

OTXT = Total number of statements on 
SYSLST. 

SM = Number of statements in source macro 
definitions. 

ETXT = OTXT IS SM - number of comment 
statements. 

LM = Number of statements in library 
macro definitions called by the 
program. 

The approximate number of tracks can be 
computed by dividing the number of bytes by 
6000 for a 2314/2319 file, by 12000 for a 
3330 file. 
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Module 19: OLTEP -574S-SC-OLT 



Modular Outline 



Partition Size 344 

Core Image Library 344 

Phases 344 

B-Transients 344 

Configuration Data Set 34 4 

Online Tests (OLTS) 344 

Generating the OLT/CDS Library . . . .344 

Relocatable Library . .345 

Modules 345 

Link-edit Statements 345 

Delete Statements 345 
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PARTITION SIZE 

14,336 bytes 

18,432 bytes with RETAIN active 



CORE IMAGE LIBRARY 



Phases 



OLTEP 



47 



3-Transients 



Blocks I 
^ 



IJZAD071 
IJZAD076 
IJZAD077 

IJZAD07 8 
IJZADOAA 
IJZADOAB 

IJZADOAJ 
IJZADOLD 
IJZADOLT 
IJZACPUT 
IJZARATA 



B-Transients 



Phases 



IJZACEOM 
IJZACOMP 
IJZACONV 



$$BOLTEP 
$$BTCLTP 

Note: The B-Transients are cataloged into 
the core iirage library along with the OLTEP 
ccirpcnent . 



IJZADOOO 
IJZADO02 
IJZADO03 
IJZADO07 
IJZADOIO 

IJZADOll 
IJZAD016 
IJZAD021 
IJZAD022 
IJZAD024 



C0NFIGURATI0N_DATA_SET 

A Configuration Data Set (CDS) is required 
in the core image library for each device 
on the system and one for the CPU. This is 
the formula for calculating the block 
requiremients: 

number of number of core image 
devices on system + 1= library blocks 
6 



IJZAD026 
IJZAD028 
IJZAD031 
IJZAD032 
IJZAD033 

IJZAD035 
IJZAD036 
IJZAD037 
IJZAD039 
IJZADO40 



ONLINE TESTS (OLTS) 

The number of core image library blocks 
required for the Online Tests (OLTs) is 
dependent en the number of devices types on 
the system, and the num.ber and size of the 
CLTs needed to test these devices. This 
information can be found in the writeup 
that accompanies the OLTs. 



IJZAD041 
IJZAD042 
IJZAD043 
IJZAD044 
IJZAD045 

IJZAD047 
IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 

IJZAD064 
IJZADO70 



GENERATING THE OLT/CDS LIBRARY 

The Program Information Department (PID) 
supplies a master tape or disk (if the 
system has no tape drives) to the Customer 
Engineer. This tape contains OLTSEP, SOSP, 
and OLTs. The EDITDOS program of the 
Standalone Service Program (SOSP) is used 
to create CLT and CDS input for the DOS 
Linkage Editor. This input can be created 
on disk or tape. 

The Job Control statements required to 
link the CLTs and CDSs into the core image 
library are as follows: 
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// JOB XXXXXXXX 

assign work files for the Linkage Editor, 

if necessary 

// ASSGN SYSIN,X'CUU' 

where cuu is the address of the tape drive. 

Disk_In2Ut 

// JOB XXXXXXXX 

assign work files for the Linkage Editor, 
if necessary 

// DLBL IJSYSIN, 'EDITPACK' 
// ASSGN SYSIN,X'CUU' 

where cuu is the address of the disk drive. 

The OLTs and CDSs are required to run tests 
under OLTEP. The customer engineer will 
create the library using the specified 
procedure. This procedure is also used to 
add new OLTs and/or CDSs when devices are 
added to the system. 



RELgCATABLE_LIBRARY 

r T 1 

1 Modules I Blocks | 

F + ^ 

] 50 I 400 1 

L X J 



Modules 



IJZABOOK 
IJZACEOM 
IJZACOMP 
IJZACONV 
IJZADOOO 

IJZADO02 
IJZADO03 
IJZADO07 
IJZADOlO 
IJZADOll 

IJZAD016 
IJZAD021 
lJZhDQ22 
IJZAD024 
IJZAD026 



IJZAD028 
IJZAD031 
IJZAD032 
IJZAD033 
IJZAD035 



IJZAD036 
IJZAD037 
IJZAD039 
IJZADO40 
IJZAD041 

IJZAD042 
IJZAD043 
IJZAD0U4 
IJZAD045 
IJZAD047 

IJZAD049 
IJZAD052 
IJZAD056 
IJZAD057 
IJZAD062 

IJZAD064 
IJZADO70 
IJZAD071 
IJZAD076 
IJZAD077 

IJZAD07 8 
IJZADOAA 
IJZADOAB 
IJZADOAJ 
IJZADOLD 

IJZABOLT 
IJZAOLTP 
IJZACPUT 
IJZARATA 
IJZATOLT 



Link-edit Statements 



INCLUDE IJZABOOK 
// EXEC LNKEDT 



Delete Statements 



DELETR I J Z. ALL 
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Module 20: BTAM -5748-SC-BTM 



Modular Outline 



Core Image Library 34 8 

BTAM Online Terminal Test Pattern 

Phase Identification 348 

BTAM Transients 34 9 

Relocatable Library 35 

Modules 350 

Concurrent OLTEP 35 

Channel Prograrr 350 

WTTA Subroutine 351 

Local 3270 Table of Comitiand Codes .351 
Channel Prograir Modules for ESC . .351 
ESC Tables of Special Characters . . 351 



Translation Tables ........ .351 

Delete Statements 352 

Source Statement Library 353 

Storage Requirements 354 

Table Requirements 354 

DTFBTNB (Define The File End: BTAM) 356 
DFTRMLST (Define The Terminal 

List: BTAM) 355 

ETMOD (BTAM Logic Module) .... .'357 
ETAM Data Event Control Elcck 

Table Requirements 357 

SCANREG Display Alphameric Control 
Area (EACA) Requirements ...... 357 



Modular Iiidex 



ESC table of special characters 357 
BTMOD (BTAM logic modules) , size of 363 



channel program modules (for 

start-stop) 356 
channel program modules for BSC 
concurrent OLTEP 356 
core image library 35 4 



357 



DACA (display alphameric control 

area) 363 
data event control block 363 
delete statements 35 8 
DFTRMLST (define the terminal list 

BTAM) 36 2 
DFTRMLST (table requirements, BTAM) 
AUTOLST/AUTOWLST 36 3 
DIALST 362 
IDLST 36 2 
OPENLST 362 
SSLAST/SSAWLST 36 3 
WRAPLST 36 2 
WTTALST 36 3 
DTFBT (define the file BTAM) , size of 

table 360 
DTFBT table requirements formula 361 
DTFETND (define the file end BTAM) , size 
of table 362 

IOCS module sizes 
BSC 357 
start-stop 356 
translate tables 357 



library book (macro) names 359 
library book (macro) , number of 359 
local 3270 table of command codes 357 

macros, IBM-supplied 359 
module names 356 
modules, number of 356 

online terminal test pattern phase 

identification 354 
online terminal test patterns 
phases 354 
transients 355 

phase names 35 4 
phases, nuitiber of 354 



relocatable library 356 
relocatable library blocks 356 

source statement library blocks 359 
source statement library macros 359 

transient routines 355 
transients, IBM-supplied 355 
translation tables 357 

WTTA subroutines 357 
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CORE IMAGE LIBRARY 



I Phases | Blocks | 



BTAM On-Line 
Terminal Test 
Patterns: 
Transients 



BTAM Transient 
Routines 
(other than 
Test Patterns) 



52 



19 



-i 



52 

14 



20 



BTAM Online Terminal Test Pattern Phase Identification 



Phase Names 



Test Patterns for Online Teririnal Tests 



IJLBOT02 
IJLBOT03 
IJLBOT04 
IJLBOT05 
IJLBOT06 

IJLBOT07 
IJLBOT08 
IJLBOT09 
IJLBOTIO 
IJLBOTll 

IJLB0T12 
IJLB0T13 
IJLBOTIU 
IJLB0T15 
IJLB0T16 

IJLB0T17 
IJLB0T18 
IJLB0T19 
IJLBOT20 
IJLB0T21 

IJLBOT22 
IJLBOT23 
IJLBOT24 
IJLBOT25 
IJLBOT26 



Transparent EBCDIC Message 
aSASCII Transparency Message 
Normal EBCDIC Message 
Normal USASCII Message 
Alphameric USASCII Message 

USASCII Printer Message 
USASCII Punch Message 
TRANSCODE Printer Message 
TRANSCODE Punch Message 
TRANSCODE Multipoint Message 

EBCDIC Printer Message 

EBCDIC Punch Message 

EBCDIC Alphameric Message 

EBCDIC Weak Pattern Message for Switched Line 

EBCDIC Weak Pattern Message for Leased Line 

TRANSCODE Weak Pattern Message for Switched Line 
TRANSCODE Weak Pattern Message for Leased Line 
EBCDIC Weak Pattern for OLE SYN Insertion 
EBCDIC 80-Character Transparent Message 
EBCDIC 120-Character Transparent Message 

EBCDIC 144-Character Transparent Message 
3270 Basic EBCDIC Test Pattern 
3270 Model 1 Align EBCDIC Test Pattern 
3270 Model 2 Align EBCDIC Test Pattern 
3270 Orders EBCDIC Test Pattern 



IJLBOT27 
IJLBOT28 
IJLBOT29 
IJLBOT30 
IJLB0T31 

IJLBOT32 
IJLBOT33 
IJLBOT34 
IJLT2ALC 
IJLT2R0T 



3270 Universal Character Set Test Pattern 
3270 NL/EOM Printer EBCDIC Test Pattern 
3270 Basic ASCII Test Pattern 
3270 Model 1 Align ASCII Test Pattern 
3270 Model 2 Align ASCII Test Pattern 

3270 Orders ASCII Test Pattern 

3270 Universal Character Set Test Pattern 

3270 NL/EOM Printer ASCII Test Pattern 

All Character Test for IBM 2848 

Rotate Test for IBM 2848 
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IJLT2TLT 
IJLT2TWS 
IJLT3ALC 
IJLT3R0T 
IJLT3SLA 



Tilt Test for IBM 2848 

Twist Test for lEM 2848 

A.11 Character Test for IBM 1030 

Rotate Test for IBM 1030 

Analyzer Test for IBM 1030 (SELECTRIC ) 



IJLT3TLT 
IJLT3TWS 
IJLT5ALC 
IJLT5R0T 
IJLT5SLA 



Tilt Test for IBM 1030 

Twist Test for IBM 1030 

All Character Test for IBM 1050 or 2740 

Rotate Test for IBM 1050 or 2740 

SELECTRIC Analyzer Test for IBM 1050 or 2740 



IJLT5TLT 
IJLT5TWS 
IJLT6ALC 
IJLT6R0T 



Tilt Test for IBM 1050 or 2740 
Twist Test for IBM 1050 or 2740 
All Character Test for IBM 1060 
Rotate Test for IBM 1060 



IJLT6SLA 
IJLT6TLT 
IJLT6TWS 



SELECTRIC Analyzer Test for IBM 1060 
Tilt Test for IBM 1060 
Twist Test for IBM 1060 



BTAM Transients 



$$ABERP1 

$$ABERP2 
$$ABERP3 
$$ABERP4 
$$ABERP5 
$$ABERP6 
$$ABERP7 
$$ABERP8 
$$ABERP9 



Control handler for BTAM special message writer and 

error statistics recorder 

BSC online test rressage writer 

Console special iressage writer 

Remote 3270 status/sense error recorder 

Error recovery message writer,, phase 1 

Error recovery iressage writer,, phase 2 

Error recovery message writer, phase 3 

RMSR record builder 

Free areas from real storage 



$$BBT3SC 
$$BBT3SI 
$$BCTC01 
$$BETPRT 
$$BHDRCK 
$$BLEPRT 
$$BLOPEN 



OLTEP device assignment 

OLTEP device assignment initiation 

CLOSE routine 

Error threshold iressage 

Terminal test request validation and comparison 

Line error print routine 

OPEN routine 



$$BOTG01 
$$BOTC02 
$$BRESPL 
$$BTCNCL 

$$BT[nEBG 
$$BT1030 



OPEN routine 

OPEN for local devices routine 

Reset Polling Lines 

Cancel routine 

Terminal test request - IBM 1030 Manual Entry and Badge Reader 

Terminal test module - IBM 1030 



$$BT1050 
$$BT1060 
$$BT2260 
$$BT2740 
$$BT2848 



Terminal test module - IBM 1050 

Terminal test module - IBM 1060 

Terminal test module - IBM 2260 

Terminal test module - IBM 2740 

Terminal test module - IBM 2848 
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RELOCATABI,E_LIBRARY 

r T 1 

] Modules I Blocks | 

I- + ■! 

1 65 I 177 I 

L X J 

Modules 



Module 




Name 


Description 


CONCURRENT 


OLTEP 



Bytes of 
Storage 



BT3270SC Concurrent OLTEP Set-up 
IJLZSCAN 



2535 
5796 



CHANNEL_PROGRAM 

(For statt-stop, the modules include a table of special characters,) 



IJLOEZ 
IJLOOY 
IJLOIJ 
IJLOIZ 
IJL02J 



WTTA 
IBM 7770 
IBM 1030 
IBM 1030 
IBM 1060 



(Auto Poll) 



(Auto Poll) 



124 
76 
187 
139 
175 



IJL02Z IBM 1060 127 

IJL03Z IBM 2848 Remote 209 

IJL04Z ATST 83B3 78 

IJL05Z Western Union 115A 72 

IJL06Z Table Generation for 2260 Local 16 

Channel Program 

IJL07J IBM 1050 Nonswitched (Auto Poll) 132 



IJL07Y IBM 1050 Switched 

IJL07Z IBM 1050 Nonswitched 

IJL08H IBM 2740 with Station Control 

(Auto Poll) 
IJLpSM IBM 2740 with Dial, Transmit 

Control, and Checking 
IJL08P IBM 2740 with Station Control 

and Checking 



202 

124 

97 

176 

132 



IJL08Q IBM 2740 with Dial and Checking 172 

IJL08R IBM 2740 with Checking 141 

IJL08U IBM 2740 with Dial and Transmit 122 

Control 

IJL08X IBM 2740 with Station Control 92 

IJL08Y IBM 2740 with Dial 114 



IJL08Z IBM 2740 Basic 
IJL081 IBM 2740 and OIU with 

Dial and Checking 
IJL082 IBM 2740 and OIU with 

Checking 
IJL089 IBM 2740 with Station 

Control and Checking 

(Auto Poll) 
IJL09Y TWX 33 
IJLIOY IBM 7772 



93 
246 

181 

145 



110 
76 
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WTTA_SyBRgyTINE 

IJLWTZ WTTA Subroutines 
LOCAL_3270_TABLE_gF_COMMANp_CODES 

IJLOHZ 3277L table of coiritiand codes 

CHANNEL PROGRAM MODULES FOR BSC 



1223 



30 



The following relocatable modules are ESC channel prograir modules for 
switched lines using ID verification (CPU-tc-CPU) . The correspondence 
between relocatable' module name and the codes that appear in the FEATURE 
operand sublist in the DTFPT macro instruction is indicated. 



IJLOBY For switched lines 

IJLOBZ For nonswitched lines 

IJLODY IBM 2780 switched point to 
point 

IJLODZ IBM 2780 nonswitched point to 
point 

IJLlBZ BSC Multipoint Lines 

IJL2DZ IBM 2780 Multipoint for 
TRANSCODE 

IJLEDIT3 Logic, TP EDIT Macro 

BSC_TABLES_gF_SPECIAL_CHARACTERS 

IJLASC In ASCII for BSC 

IJLEBD In EBCDIC for BSC 

IJLTCD In 6-bit transcode for ESC 

TRANSLATigN_TABLES 

IJLRASA For USASCII to EBCDIC for BCS 

IJLRCTW For ITA2 to EBCDIC (World Trade 

Teletype) 

IJLRCTl From BAUDOT to EBCDIC 

IJLRCT2 From TWX TO EBCDIC 

IJLRCT3 From ZSC3 to EBCDIC (World 

Trade Teletype) 
IJLRC30 From 1080 to EBCDIC 
IJLRC40 From 2740 to EBCDIC 

(lowercase) 
IJLRC5 From 1050 to EBCDIC 

(lowercase) 
IJLRC60 From 1060 to EBCDIC 

IJLRC80 From 6-Bit 

TR?lMSCODE to EBCDIC 

IJLRFUO From 2740 to 

EBCDIC (uppercase) 

IJLRF50 From 1050 

to EBCDIC (uppercase) 

IJLRSCI From USASCII 

to EBCDIC with 2848 
Attached to 2701 via IBM 
Terminal Control Type III 



415 
281 
212 

148 

253 
136 

2090 



85 
85 
69 



256 
256 

256 
256 

256 

256 
256 

256 

256 

256 

256 

256 

256 
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IJLSASA From EBCDIC to 256 

USASCII for BSC 

IJLSCTW From EBCDIC 256 

to ITA2 (World Trade Teletype) 

IJLSCTl From EBCDIC to BAUDOT 256 

IJLSCT2 From EBCDIC to TWX 256 

IJLSCT3 From EBCDIC to 256 

ZSC3 (World Trade Teletype) 

IJLSD30 From EBCDIC to 1030 256 

IJLSD40 From EBCDIC to 2740 256 

IJLSD50 From EBCDIC to 1050 256 

IJLSD60 From EBCDIC to 1060 256 

IJLSD80 From EBCDIC to 256 

6-bit TRANSCODE 
IJLSSCI From EBCDIC to 256 

USASCII with 2848 Attached 

to 2701 via IBiyi Terminal 

Control Type III 



Delete Stat ementg 

To delete the BTAM phases from the core image library, the BTAM 
modules from the relocatable library, and the ETAiV! becks from the source 
statement library, you must supply the DELET card for the appropriate 
library and the name of the phase, module, cr bock to be deleted. For 
example: 

// JOB DELETC 
// EXEC MAINT 

DELETC $$ECT01,$$BETPRT,etc. 

DELETC IJLT2ALC,IJLT2ROT,etc. 

DELETR IJL00Y,IJL01Z,IJL02Z,etc. 

DELETS E. CONTROL, E.LERB, etc. 
/g 

To delete both BTAM and QTAM from the core image, relocatable and 
source statement libraries, the DELET card for the appropriate library 
and the following entries must be made: For the core image transients, 
you must supply the DELETC card with a separate entry fcr each transient 
(QTAM and BTAM) to be deleted. For the core image phase names, enter 
the delete card as follows: 

DELETC $$BCTC01,$$BOOO0 3,$$BETPRT,etc. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delate both BTAM and QTAM from the relocatable library enter the 
delete card as follows: 

DELETR IJL.ALL 

To delete the BTAM and QTAM books from the source statement library, 
enter the DELETS card with a separate entry for each bock to be deleted. 
The following example shows the required delete cards and type of 
entries to be made in those cards: 

// JOB DELETE 
// EXEC MAINT 

DELETS E. CONTROL, E.CANCELM, etc. 
/g 
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SOURCE STATEMENT LIBRARY 



r T 1 

I Macro] Blocks | 

I- + ^ 

I 64 I 7842 I 

L X J 



Macros 



Basic 



St ora ge Eytgs 



For Variables 



E.AS 

E.ASCTR 

E.ASLIST 

E.BTBONLT 

E.BTBTEIH 

E.BTBTFIX 

E.BTBTFREE 

E.BTBTROD 

E.BTBTRSCH 

E.BTCEMODE 

E.BTCKID 

E.BTCONST 

E.BTCSE 

E.BTCTUPT 

E . BTMOD 

E.BTNCKID 

E.BTOLTCMP 

E.BTOLTIH 

E.BTONLAP 

E.BTONLOA 

E.BTRD 

E.BTRLBF 

E.BTRQBF 



(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 

(inner macro in BTMOD) 



E.BTRWC 
E.BTTRANS 
E.BTWAIT 
E.CHGNTRY 



E.CONFIGUR 
E. CONTROL 
E.CTRGROaP 
E.CTRLIST 
E.CTRSCHED 



(inner macro in BTMOD) 



20 (Start-stop) +6 (Note 2) 

72 (BCS) 

20 (Start-stop Auto Poll) +72 (Note 2) 

22 (2260 Local) +4 (Note 2) 



20 



+38 (Note 2) 



E.DEULIST 

E.DISPGUID 

E.DFTRMLST 

E.DTFBT 

E.GDUAS 

E.GDULIST 

E . GDOTRZiMS 



E.LERB 

E.LERPRT 

E.LOPEN 

E.ONLTST 

E.PARAMNQM 

E.PARMLIST 

E.RELBUF 



20 
14 
8 



14 



+8 (Note 2) 
+2 (Note 2) 



+4 (Note 3) 
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E.REQBUF 12 +8 (Note 4) 

E.RESETPL 12 +4 (Note 2) 

E.RMSRTAB 

Z.SAMP327L 

Z.SAiyiP327R 

E.SCANRE2 

E.SDRTAB 

E.STEND 

E.TGROUP 

E.TPEDIT 

E.TRLIST 

E.TRANSLAT 

E.TRNSLATE 26 +16 (Note 2) 

E.TRSRCTW 256 

E.TRSRCT3 256 

E.TRSSCTW 256 

E.TRSSCT3 256 

E.TWAIT 24 +20 (Note 4) 

Notes; 

1. n=number of different operands coded. 

2. No operands coded in register notation. 

3. First operand not coded in register notation. 

4. All possible operands not coded in register notation. 

Storage _Reguireinents 

DTFBT__(DEFINE_THE_FILEl BTAM)_ 

TABLE REQUIREMENTS 

Size = 64 + N (40 + 8x) + BUFCB + BUFNO (BUFL + f) + y + z 
(+ 32N for BSC only) 

Where: 

N = number of lines in the line group (or, for a local 226 and 
local 3270**, the number of devices attached to the control 
unit) 
X = number of CCWs in the largest channel prograir available for 
the device, given in Figure 20-1 
♦BUFCB = 8 if a buffer pool is used 

= if a buffer is not used 
♦BUFNO = number of buffers in the pool 
♦BUFL = length of each buffer 

f = number of bytes required to extend each buffer to a irultiple 

of 8 
y = size of the model channel program table for the line group, 
given in Figure 20-1. If two or more DTFBTs use the same 
model channel program and are linkage edited together, 
include the value only once. 
Z = Size of the table of special characters given in Figure 
20-1. For BSC only, if two or more DTFBTs use the same 
transmission code, include the value only once. 

* If the buffer pool is shared by two or more DTFBTs, include the value 

only once. 
♦* For a local 3270, at least one DTFBT is required for each control 

unit. 
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Auto Poll] 


y 
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r 




T 




r 
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11030 






7 


9 1 


84 


23 


jlOSONS 






7 


9 1 


68 


16 


I1050S 






11 




136 


34 


11060 






6 


9 1 


80 


15 


I2260L 






1 


1 Not 


applicable 


Not applicable 


I2260R 






7 




136 


20 


12740 






4 




24 


21 


1 2740C 






4 




68 


33 


I27U0DC0 






8 




207 


30 


1 2740C0 






8 




155 


24 


I27U0D 






6 




52 


18 


I2740DC 






7 




100 


32 


I27U0DT 






8 




68 


22 


1 27 4 0DTC 






8 




116 


36 


I2740S 






6 


9 1 


48 


12 


12740SC 






7 


9 1 


84 


24 


13277L 






3 




28 


Not applicable 


|115A 






4 




36 


4 


|83B3 






5 




40 


6 


JTWX 3 3/35 






7 




56 


18 


1 WTTA 






5 




52 


36 


|BSC1; also 


1130, 




8 




248 


53 


1 2780, and 2020 












1 nonswitched point | 










1 to point 














|BSC2; also 


1130, 




8 




372 


53 


1 2780, and 2020 












1 switched 


point 












1 to point 














|BSC3; also 


1130, 




8 




252 


53 


1 2780, 2020, and 












I 2972 multipoint. 












|2780 transcode. 




8 




111 


53 


1 nonswitched point] 










1 to point. 














|2780 transcode. 




8 




175 


53 


1 switched 


point 












1 to point 














|2780 multipoint 




8 




123 


53 



L X X X J 

Figure 20-1. BTAM — Parameters for DTFET Table Requirements Formula 
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DTFBTND (Define The File End; 



BTAM) 



This macro instruction does not require storage at execution time. 



DFTRMLST (Define The Terminal List; BTAM) 

Table Requirements for OP ENLST and WRAPLSt 
Size = n (m + 1) +2 

where: n = number of list entries 

ra = number of polling/addressinf characters--a function of the 
device, as shown in Figure 20-2 



Device 



1 1030 




1 1 


1 1050NS 




2 1 


1 1050S 




2 1 


1 1060 




2 ! 


1 2260L 


Not 


applicable | 


1 2260R 




2 1 


1 2740 


Not 


applicable | 


1 2740C 


Not 


applicable | 


i 2740D 


Not 


applicable | 


1 2740DC 


Not 


applicable | 


1 2740DT 


Not 


applicable | 


1 2740DTC 


Not 


applicable | 


1 2740S 




1 1 


1 2740SC 




1 1 


1 2740DC0 


Not 


applicable | 


1 2740C0 


Not 


applicable | 


1 3277R 




5 1 


1 115A 




2 1 


1 83B3 




2 1 


1 1130 




2 i 


1 2780 




3 1 


1 WTTA 


Not 


applicable | 


L — J 


L 


. _j 



Figure 20-2. BTAM — Number of Polling/Addressing Characters 

Table Requirements for DIALST 
Size = n(m +1) +l+q+p+i 



where: 



n = number of list entries 

m = values specified in Figure 20-2 

q = 2 if the list includes entries for polling or addressing 

= otherwise 

p = number of dial digits 

i = 3 if the inlist operand is coded (ESC only) 

= otherwise 

3!able_Reguirements_for_IDLST 

Size of TWX calling list = d + 5 + 2b 

Size of TWX answering list = 5 •♦• b 

Size of ESC IDLST only =3+d+2r+s+i 



where: 



d = number of dial digits 
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b = number of TWX ID characters 

= otherwise 

r = number of ID characters expected to be received (BSC) 

s = number of ID characters to be sent (ESC) 

i = 3 if the inlist operand is coded (ESC) 

= otherwise 

Table Requirements for SSLAST/SSAWIST 
Size = n(m +1) +6 

where: n = number of list entries 

m = values specified in Figure 20-2 

Table Requirements foy AUTOLST/AUTCWLST 
Size = n(m +2) + 8 19 

where: n = number of list entries 

m = values specified in Figure 20-2 

Table _Requirements__f or WTTALST 

1. When the WRU feature is present in DTFBT: 
Size = 3 + 2r + s 

2. When the lAM feature is present, and WRU is not present in DTFBTj 

Size = 2 + s 

where: r = number of ID characters expected tc be received 
s = number of ID characters to be sent 



BTMQD (BTAM Logic Module) 

The size of the BTAM module varies with the options selected as shown in 
Figure 20-3. When all operands are omitted or the standard (default) 
options are coded, the resulting basic module requires 7100 bytes of 
main storage. 

BTAM DATA EVENT CONTROL BLOCK TABLE REQUIREMENTS 

Size = 40 bytes 

When the MF operand of a READ or WRITE macro is coded MF=L, or when 
the MF operand is omitted, a Data Event Control Block (DECB) is 
reserved. One DECB should be reserved per line. 

SCANREQ DISPLAY ALPHAMERIC CONTROL AREA (DACA) REQUIREMENTS 

Size of each DACA = 24 bytes 

When the MF operand of a SCANREQ macro is ceded MF=L, or when the MF 
operand is omitted, a Display Alphameric Control Area (DACA) is 
reserved. One DACA should be reserved per device. 
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r T T 

I Operand | Option | Number of bytes added to basic module 



N 



-2040 



I- 



ERLOGIC=*| C 
I NC 



— + 



+ 400 
-1800 



+1700 (If BUFFER=NO, BSCTEST=NO) 



YES 



+1750 (If BUFFER=YES, BSCTEST=NO) 



+1800 (If BUFFER=YES, BSCTEST=YES) 



SWITCH 



I 

I NEWID 

I 
I 



+2900 (If EUFFER=NO, BSCTEST=NO) 
+2950 (If BUFFER=YES, ESCTEST=NO) 
+3000 (If BUFFER=YES, BSCTEST=YES) 



AUDIO 



YES 



+ 410 (SWITCH must equal YES) 



+1950 (If L2260=NO and L3277=NO) 



YES 



+2075 (If L2260=NO or L3277=YES) 



BUFFER= \- 



+ 710 (If L2260=NO and L3277=NO) 



I REQREL 



+ 825 (If L2260=YES or L3277=YES) 



TERMTST= 



YES 



+ 1044 



- 980 (If ERIOGIC=N) 



I 
L2260= I YES 

I 
L3277 I NO 



+1440 (If ERIOGIC=E) 



+1750 (If ERIOGIC=C) 



- 730 (If ERLOGIC=NC) 



* Use the ERLOGIC storage estimate only if neither L2260, nor L3277, nor 
$SAPL is specified. 

Figure 20-3. BTAM — Storage Requirements (Part 1 of 2) 
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r T T 

I Operand | Option | Number of bytes added to basic module 



L2260 
L3277 



15 (If ERLOGIC=N) 



NO 
NO 



+ 2680 


(If 


ERLOGIC=E) 


+ 3000 


(If 


ERLOGIC=C) 


+ 270 


(If 


ERLOGIC=NC) 


+ 770 


(If 


ERLOGIC=N) 


+ 3725 


(If 


ERLOGIC=E) 


+ U050 


(If 


ERIOGIC=C) 



L2260 
L3277 



YES 
YES 



+1160 (If ERLOGIC=NC) 



TST3277 



YES 



+1325 (nL3277 must equal YES) 



TRANSL= 



YES 



+ 170 



+11000 (If SWITCH=YES and EUFFER=YES) 



BSCS = 



YES 



+7960 (If SWITCH=YES and BUFFER=NO) 
+6235 (If SWITCH=NO and BUFFER=NO) 



+9240 (If SWITCH=NO and BUFFER=YES) 
+9125 (If SWITCH=NEWID and BUFFER=NO) 
+12180 (If SWITCH=NEWID and BUFFER=YES) 



SSAPL= 



YES 



-1170 (If ERLOGIC=N) 



+1520 (If ERLOGIC=E) 
- 910 (If ERIOGIC=NC) 
+1830 (If ERIOGIC=C) 



BSCMPT= 



YES 



+1150 (BSCS must equal YES) 



WTTA 



YES 



+ 320 



BSCTEST 



YES 



+ 3320 



DECBEXT 



X Eo 



t»0 (BSCS must equal YES) 



RMSR= 



YES 



+568 (If L2260=NO and L3277=NO) 



+ 694 


(If 


L2260= 


=YES 


and 


L3277 


=N0) 


+ 726 


(If 


L2260= 


=N0 


and 


L3277= 


YES) 



+ 852 (If L2260=YES and L3277=YES) 



RESETPL I NO 
L X 



+ 120 



Figure 20-3. BTAM — Storage Requirements (Part 2 of 2) 
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Module 21: QTAM -5745-SC-QTM 



Modular Outline 

Core Image Library 36 2 

Transients 362 

Relocatable Library 362 

Modules 362 

Basic QTAM Logic Modules 362 

QTAM Device I/O Modules 36 2 

Delete Statements 368 

S6urce Statement Library 36 9 

Macros 369 

QTAM Storage Requirements 370 

DTFQT (Define The File: QTAM) . . .370 

Control Information 371 

Buffers .372 

QTAM Macro Instructions 372 



Modular Index 



basic logic modules and storage 

requirements 36 8 
basic QTAM logic modules 36 8 
buffer requirements , audio 

applications 378 
buffer requirements, nonaudio 

applications 378 

control information storage 

requirements 377 
core image library 36 8 
core image library blocks (transients) 368 

delete statements 374 

device I/O modules requirements 368 

DTFQT 

(define the file QTAM) , size of 

tables 
audio output queue table requirements 

(QTAM) 377 
checkpoint records table 

requirements 376 
comm. line group file table 
requirements 376 



library book (macro) names 375 
library book (macro) number of 375 
message queues file table 

requirement QTAM 376 
real storage destination queue, 

table requirement 37 6 
real storage process queue table 

requirement 376 

macros, IBM-supplied 375 
macro instructions storage 

requirements 378 
module names 369-373 
modules, number of 36 8 

relocatable library 36 8 
relocatable library blocks 36 8 

source statement library blocks 375 
source statement library macros 375 

transient routines 36 8 



values for communication line group 
table 376 
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CORE_IMAGE_LIBRARY 

r T 1 

I Transients | Blocks | 
^ _ 1 ^ 

I I 22 I 34 I 

• L J. J 

Transients 



$$BCQC01 
$$BCQC02 
$$BCQC03 
$$BOQO01 
$$BOQ002 
$$BOQO03 

$$BOQO04 
$$BOQO06 
$$BOQO07 
$$BOQ008 
$$BQCNCL 
$$BQCNCM 

$$BQHDCK 
$$BQWTRA 
$$BQWTR1 
$$BQWTR2 
$$BQWTR3 

$$BQ1030 
$$BQ1050 
$$BQ1060 
$$BQ2260 
$$BQ2740 



Close Phase 1 

Close Phase 2 

Close Phase 3 

Open Monitor/DASD Message Queues, Phase 1 

Open Line Group and Main Storage Process/Destination Queues 

Open Checkpoint/Restart, Phase 1 

Open Checkpoint/Restart, Phase 2 

Open Main Storage Process/Destination Queues 

Open Phase 7 

Open Audio Line Group and Output Queue 

Cancel 

Cancel 

Terminal Test Header Analysis 
ARU Message Writer 
Message Writer, Phase 1 
Message Writer, Phase 2 
Message Writer, Phase 3 

Terminal Test Module for IBM 1030 

Terminal Test Module for IBM 1050 

Terminal Test Module for IBM 1060 

Terminal Test Module for IBM 2260 

Terminal Test Module for IBM 2740 



RELOCATABLE_LIBRARY 

r T 1 

I Modules I Blocks | 

I- + -I 

I 109 I 393 I 

L X J 

Modules 



BAS IC QTAM LOGIC MODULES; Basic QTAM Logic modules are identified by 
one asterisk (*) preceding the listed module. 

QTAM DEVICE I/O MODULES; QTAM device I/O modules are identified by twc 
asterisks (**) preceding the listed module. Include the storage 
requirements for a particular device I/O module only once, and only if 
the terminal type is present in the system. 
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Module 




Bytes of 


Name 


Description 


Storage 


IJLQAA 


Audio Line Appendage 


2386 


Note: 


Required if the QTAM 
audio support is 
selected. 




IJLQAD 


Audio 7772 disk appendage 


2898 


IJLQBO 


Breakoff (BREAKOFF) 


212 


♦IJLQCK 


Checkpoint 


1208 


Note: 


Required if the 
Checkpoint/Restart 
Facility is selected 
in the DTFQT. 




IJLQCL 


Change Line (STARTLN AND 
STOPLN) 


557 


IJLQCM 


Cancel Message (CNACELM) 


160 


IJLQCP 


Change Polling List 
Entry (CHNGP) 


146 


IJLQCR 


Checkpoint Request (CKREQ) 


98 


IJLQCT 


Change Terminal Table 
Entry (CHNGT) 


250 


♦IJLQDA 


Disk I/O Module 


1372 


Note: 


Not required when the system 




contains only audio devices. 




IJLQDC 


Copy Counters (COPYC) 


280 


IJLQDE 


Copy Terminal Table 
Entry (COPYT) 


120 


IJLQDL 


Distribution List 


156 


IJLQDP 


Copy Polling List 
Entry (COPYP) 


104 


IJLQDQ 


Copy Queue Control 
Block Status (COPYQ) 


98 


IJLQDT 


Insert Date in Message 
Header (DATESTMP) 


60 


IJLQEA 


End-of-Address (EGA) 


100 


IJLQEB 


End-of-Block (EOB) 


132 


IJLQEC 


End-of-Block and Line 
Correction (EOBLC) 


396 


IJLQER 


Error Message (ERRMSG) 


292 


IJLQEX 


Expand Message header 


70 


IJLQFL 


DTF Locator 


78 


IJLQGA 


Get Audio Message 


324 


IJLQGB 


Get Audio or Nonaudio 


732 



IJLQGC 



IJLQGD 



IJLQGM 

IJLQGR 
IJLQGS 
♦IJLQIP 
IJLQIT 



Message 
Get audio message 
or nonaudio message 
record (GET) 
Get audio message 
or nonaudio message 
segment (GET) 
Get complete message 
(GET) 

Get message record (GET) 
Get message segment (GET) 
QTAM implementation 
Intercept message 
(INTERCPT,, permanent 
queuing) 



760 



714 



472 

500 

454 

3692 

140 
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Module 
Name 



Description 



Bytes of 
Storage 



♦ IJLQLA Line appendage and ERP rrcdule 4152 
PCI and program 
Note: Not required when the 
system contains only 
audio devices. 
♦IJLQLC Line appendage for PCI and 630 
program check module 
Note: Not required when the system 
contains only audio devices. 
IJLQLG Audio input message 304 

logging (LOGSEG) 
IJLQLK Lookup terminal 104 

table entry (DIRECT) 
♦IJLQLO IBM 2260 local 1288 

appendage 
Note: Required if the IBM 
2260 local device is 
used. 
IJLQMC Conversational 384 

mode (MODE) 
IJLQMI Initiate mode (MODE) 18 

IJLQMM Message-mode inter- 44 

face (MODE) 
IJLQMP Priority mode (MODE) 36 

IJLQMT Compare Message Type 60 

(MSGTYPE) 
♦IJLQMW Error recovery proce- 1359 

dures message writer 
subtask 
**IJLQMO Model channel prcgrair 194 

for IBM 1030 terminals 
**IJLQM1 Model channel program 168 

for IBM 1060 terminals 
**IJLQM2 Model channel prcgrair 206 

for IBM 2260 terminals 
♦♦IJLQM3 Model channel program 102 

for ATST 83B3 terminals 
**IJLQM4 Model channel program 91 

for Western Union Plan 
115A terminals 
**IJLQM5 Model channel program 207 

for IBM 1050 switched 
and nonswitched terminals 
♦♦IJLQM6 Model channel program 194 

for IBM 1050 nonswitched 
terminals 
**IJLQM8 Model channel program 113 

for AT&T TWX terminals 
(Models 33 and 35) 
**IJLQM9 Model channel program 75 

for IBM 2260 local 
terminals 
**IJLQN0 Model channel program 99 

for IBM 2740 Basic 
terminals 
**IJLQN1 Model channel program 166 

for IBM 2740 Basic 
Dial terminals 
**IJLQN2 Model channel program 172 

for IBM 2740 terminals 
with station control 
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Module 
Name 



Description 



Bytes of 
Storage 



♦ ♦IJLQN3 Model channel prograrr 

for IBM 2740 terminals 
with station control 
checking 

♦♦IJLQN4 Model channel program 
for IBM 2740 dial 
terminals with transient 
control and checking 

♦♦IJLQN5 Model channel program 

for IBM 2740 terminals 
with checking 

♦♦IJLQN6 Model channel program 
for IBM 2740 dial 
terminals with checking 

**IJLQN7 Model channel program 
for IBM 2740 dial 
terminals with transmit 
control 

♦♦IJLQN8 Model channel program 

for World Trade Telegraph 
Terminals (WTTA) 



221 



198 



128 



192 



156 



356 



IJLGOA 


Operator awareness 


1380 


IJLQOB 


SDR counter incrementer 


2576 


IJLQOC 


Operator Control 
(OPCTL) 


3530 


IJLQPA 


Put audio message 
(PUT) 


370 


IJLQPL 


Polling limit con- 
trol (POLLIMIT) 


120 


IJLQPM 


Put complete message 
(PUT) 


480 


IJLQPR 


Put message record 
(PUT) 


544 


IJLQPS 


Put message segment 
(PUT) 


520 


IJLQPZ 


Pause-transmit idle 
characters (PAUSE) 


360 


IJLQQT 


Close message 
control (CLOSEMC) 


474 


IJLQRA 


Translate table 


266 



IJLQRB 



IJLQRC 



IJLQRD 



IJLQRG 
IJLQRM 

IJLQRR 



RCVARU: ARU code 

to EBCDIC 
Translation table 

RCVITA2 (EBCDIC to 

International Telegraph 

Alphabet No. 2) 

Translation table RCVZ- 

RCVZC3 (EBCDIC to 

Figure-Protected 

Code ZSC3) 
Retrieve message 

segment by DASD 

address (RETRIEVE) 
Route message (ROUTE) 
Release message 

(RELEASEM) 
Reroute message 

(REROUTE) 



266 



266 



124 



48 
234 

72 
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Module 
Name 



Description 



Bytes of 
Storage 



IJLQRS Retrieve message 

header by sequence 
number (RETRIEVE) 

♦IJLQRW Physical input/output 
control 
No te; Not required when the 
system contains only 
audio devices. 

IJLQRl Translate table 

RCV1030: 1030 to 
EBCDIC 

IJLQR2 Translate table 

RCV1050: 1050 to 
EBCDIC 

IJLQR3 Translate table 

RCV1050F: 1050 to 
monocase EBCDIC 

IJLQRU Translate table 

RCV1060: 1060 to 
EBCDIC 

IJLQRS Translate table 

RCV2260: 2260 to 
EBCDIC 

IJLQR6 Translate tables 

RCV83B3 or RCV115A: 
ATgT 83B3 or WU Plan 
115A to EBCDIC 

IJLQR7 Translate table 

RCVTWX: AT&T Models 
33/35 (TWX) to 
EBCDIC 

IJLQRS Translate table 

RCV27U0: 2740 to 
EBCDIC 

IJLQR9 Translate table 

RCV2740F: 2740 to 
EBCDIC 

IJLQSB Translation table 
SNDITA2 (Interna- 
tional Telegraph 
Alphabet No. 2 to 
EBCDIC) 

IJLQSC Translation table 
SNDZSC3 (Figure- 
Protected Code ZSC3 
to EBCDIC 

IJLQSH Scan message header 

IJLQSI Sequence-in number 

verification (SEQIN) 

IJLQSK Skip-through-character 
(SKIP) 

IJLQSO Insert sequence-out 
number in message 
header (SEQOUT) 

IJLQSR Source terminal naire 

verification (SOURCE) 

IJLQSS Change audio line 

(STARTARU and STOPARU) 



380 



1569 



266 



266 



266 



266 



266 



266 



266 



266 



266 



266 



266 



104 
140 

76 



128 
300 
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Module 




Bytes of 


Name 


Description 


Storage 


IJLQST 


Skip-on-count (SKIP) 


48 


IJLQSl 


Translate table 
SND1030: EBCDIC 
to 1030 


266 


IJLQS2 


Translate table 
SND1050: EBCDIC 
to 1050 


266 


IJLQSU 


Translate table 
SND1060: EBCDIC 
to 1060 


266 


IJLQS5 


Translate table 
SND2260: EBCDIC 
to 2260 


266 


IJLQS6 


Translate tables 
SND83B3 or SND115A 
EBCDIC to AT&T 83B3 
or WU Plan 115A 


266 


IJLQS7 


Translate table 
SNDTWXE: EBCDIC to 
AT6T Models 33/35— 
TWX (even parity) 


266 


IJLQS8 


Translate table 
SND2740: EBCDIC TO 
2740 


266 


IJLQS9 


Translate table 
SNDTWXO: EBCDIC 
to ATgT Models 
33/35— TWX (nonparity) 


266 



♦IJLQTA 



Note; 



World Trade Tele- 
graph Terminals 
(WTTA) Line Appen- 
dage 

Required if World 

Trade Telegraph support 

is selected. 



1406 



IJLQTR Code translation 

used in conjunction 
with QTAM or user 
provided translate 
table (TRANS) . 
Note; T = number 

of translation tables, 



114+226T 



IJLQTS Insert time-of-day 
in message header 
(TIMESTMP) 



198 



♦IJLQTT Terminal test 

recognition (LPSTART) 
Note : Not required when the 

system contains only audio 
devices. 



1394 
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Delete _staternents 

To delete the QTAM phases from the core image library, the QT?^M irodules 
from the relocatable library, and the QTAM books from the source 
statement library, the DELET card for the appropriate library and the 
name of the phase, module or book to be deleted must be supplied. For 
example: 

// JOB DELETE 
// EXEC MAINT 

DELETC $$BCQC01,$$BQWTRl,etc. 

DELETE IJLQBO,IJLQCL,IJLQCM,etc. 

DELETS E . BREAKOFF , E . BUFFER , E . CANCELM , e tc . 
/& 

TO delete both BTAM and QTAM from the core image, relocatable and 
source statement libraries, the DELET card for the appropriate library 
and the following entries must be made: For the core image transients, 
you must supply the DELETC, card with a separate entry for each 
transient (QTAM and BTAM) to be deleted. For the core image phase 
names, enter the delete card as follows: 

DELETC $$BCTC01,$$BCOO03,$$BETPRT, etc. 
DELETC IJLB.ALL 
DELETC IJLT.ALL 

To delete both BTAM and QTAM from the relocatable library enter the 
delete card as follows : 

DELETR IJL.ALL 

To delete the BTAM and QTAM books from the source statement library, 
enter the DELETS card with a separate entry for each book to be deleted, 
The following example shows the required delete cards and type of 
entries to be made in those cards. 

// JOB DELETE 
// EXEC MAINT 

DELETS E, CONTROL, E. CANCELM, etc. 
/g 
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SOURCE_STATEMENT_LIBRARY 

r T 1 

j Macro I Blocks | 

I 1 78 I 2013 I 
■ L X J 

Macros 

Basic 

E.ARUMGTYP 
E.BRER.KOFF 
E.BUFARU 
E. BUFFER 
E.CANCELM 



E.MSGTYPE 
E.OPCTL 

E. OPTION 
E. PAUSE 
E.POLL 
E.POLLIMIT 
E.POSTARU 

E.POSTRCV 
E.POSTSEND 
E.PREFIXD 
E. PROCESS 
E.QCBD 

E.RCVHDR 
E.RCVITA2 
E.RCVSEG 
E.RCVZSC3 

E.RELEASEM 



E.CHECKARU 

E.CHNGP 

E.CHNGT 

E.CKREQ 

E.CLOSEMC 



E. REPEAT 
E. REROUTE 
E. RETRIEVE 
E. ROUTE 
E.SENDHDR 



E.COPYC 

E.copyp 

E.COPYQ 
E.COPYT 
E. COUNTER 



E.SENDSEG 

E.SEQIN 

E.SEQOUT 

E.SKIP 

E.SNDITA2 



E.CTLTBL 
E.DATESTMP 
E. DIRECT 
E.DTFQT 
E.ENDRCV 



E.SNDZSC3 
E. SOURCE 
E.STARTARU 
E.STARTLN 
E.STCBD 



E.ENDREADY 
E.ENDSEND 
E.EOA 
E.EOB 

E.EOBLC 

E.ERRMSG 

E.INTERCPT 

E.LCBD 

E.LINE 

E.LINETBL 

E.LIST 

E.LOGSEG 

E.LPSTART 

E.MODE 



E.STOPARU 

E.STCPLN 

E.TERM 

E.TERMTBL 

E.TERMTBLD 

E.TIMESTMP 
E. TRANS 
E.WORD 
E.WORDTBL 
E.WRU 

System Generation 

E.IJLQDSCT 
E.IJLQTSVC 
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QTAM_STORAGE_REQUIREMENTS 

The storage requirements for QTAM depend to a great extent on the 
configuration of your teleprocessing installation and the nature of your 
applications. Storage requirements increase proportionately as the 
number of communication lines, teririnals, and QTAM-provided processing 
functions increase. These requirements can be estimated from formulas 
and tables presented in this' module. 

To determine the storage requirements for the Basic QTAM Logic 
modules and the QTAM Device I/O modules, refer to "Relocatable Library". 



DTFQT (Define The File; QTAM) 



Seven types of DTP tables miay be generated by a DTFQT macro instruction. 
The storage estimates for each follow. 

DASD Message Queues_Files 
Size = 315 bytes 

Communication Line_Qroup File 
For Nonaudio Line Group 
Size = 48 + (128 + 8x)N 

For Audio Line Group 

Size = 64 + (161 + L^ + La + G + x-z)N 

where: N = number of lines in the line group 

X = a function of the device, given in Figure 21-1 

Li = length of input buffers 

Lz = length of address chain buffers 

G = 9 when using time stamping option, otherwise = 

z = 17 when information mode is used 



I Device 
I- 



I Device 
J. 



11030 


8 


|274E 


7 1 


I1050NS 


8 


|274F 


4 1 


I1050S 


10 


1 274G 


6 1 


11060 


7 


|274H 


7 i 


12260 Remote 


8 


|115A 


8 1 


1 2260 Local 


5 


1 83B3 


7 1 


|274A 


4 


ITWX33/35 


6 1 


|274B 


6 


17770 


1 


|274C 


6 


1 WTTA 


8 1 


|274D 


7 


L J 


L J 


L J 


L i 







Figure 21-1. QTAM — Values for Communication Line Group Table 

Size = 84 + 12x 

where: x = for nonmixed application, and 
1 for mixed application 

Real Storag e D estination Queue 
Size = 80 bytes 

Checkpoint_Records File 
Size = 220+L 
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where: L = length of the Checkpoint record specified ty the SOWA 
keyword operand. 

Audio Qutput_Queue 
Size = 76 bytes 

CONTRqL_INFgRMATION 

The storage estimates for required control information are shown in 

Figure 21-2. 



I Control Blocks and Information | 



Storage Requirerrents (in bytes) | 

^ 



Terminal table 

TERMTBL macro instruction 

OPTION macro instruction 



TERM macro instruction^ 



LIST macro instruction^ 



PROCESS macro instruction^ 



12 



No Storage is reserved for this 
macro; it defines user areas 
that are included in the expansion 
of the TERM macro instruction 
(U parameter) 



9+I+U+D+ U4F 
where: (I + U + D)<243 



12 + L + 2N + 1402 
where: (3 + L +2N)<243 



13 + A for audio process 
program entry 
9 + Y for ncnaudic process 
program entry 



Polling list 

POLL macro instruction^ 



4 + 3N for autopolled terminals 
except IBiyi 1030 

4 + 2N for ncnswitched terminals 
or autopolled IBM 1030 

5 for switched IBM terminals 
3+1 for TWX 

4 + T for WTTA terminals 



Queue Control Block for Process 
Queues and Destination Queues 



32X 



Audio Line Table 

LINETBL macro instruction*- 

LINE macro instruction^ 



5 + Z 



Audio Word Table 

WORDTBL macro instruction^ 

WORD macro instruction^ 



+ W 



Figure 21-2. QTAM--Storage Requirements for Control Information (Part 1 
of 2) 
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Buffers 

For Nonaudio Applications: 

Buffer Pool Size = 8+(x+16)N + 24M 

where: N = number of buffers specified. 
X = size of each buffer 

M = number of CCWs QTAM generates for data insertion by the 
PAUSE macro 

r ' ' 

where: N = number of teritiinals 

I = number of bytes in terminal ID 

U = number of bytes in optional area 

D = number of bytes in device address area; size depends on contents: 

For nonswitched terminal — addressing and polling characters (1 

byte/character) 
For IBM switched teririnal--f ield telling the number cf dial digits (1 
byte) + dial digits (1 byte/digit) + addressing characters (1 
byte/character) 
For TWX--field telling the number of dial characters (1 byte) + dial 
digits (1 byte/digit) + field telling the number of ID characters (1 
byte) + ID characters (2 bytes/character) 
For WTTA terminals — 1 byte + field telling the number cf ID characters (1 

byte) + ID characters (2 bytes/character) 
For IBM 2260 Local--a field cf 6 fullwords consisting cf a CCB and other 
control information 
L = number of bytes in name cf the distribution list entry in terminal table 

(1-8) 
A = number of bytes in name of the audio process entry in the terminal table. 
Because the following field in the entry must be aligned to a fullword 
boundary, this field must be either three, seven or eleven bytes long. 
X = number of lines or terminals (depending on queueing techniques) and the 

number of process queues 
Y = number of bytes in name of the process entry in terminal table (1-8) 
Z = number of bytes in name of the line entry in line table (1-8) 
W = number of bytes of the selected word 
F = 1 for IBM 2740 Model 2 terminals with the Buffer Receiver Option; for 

other terminals 
T = number of bytes in the CPU identification (WTTA terminals) 
j. _ ^ 

Notes : 

1. Add the number of bytes necessary for fullword boundary. 

2. This number (140) is the number of bytes in the Distribution List module (IJLQDL) . 
This number is included in the storage requirements only once if the LIST macro is 
used more than once. 

3. Add the number of bytes necessary for halfword boundary. 

L J 

Figure 21-2. QTAM--Storage Requirements for Ccntrcl Information (Part 2 
of 2) 



QTAM Macro Instructions 

Figure 21-3 gives the storage requirements for all other QTAM macro 
instructions . 
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Much QTAM logic consists of modules introduced by the use of certain 
QTAM macro instructions in the user's program. These iracro instructions 
expand into in-line coding that establishes the linkage to, and 
parameters for, the QTAM modules. Often a module so introduced into the 
system itself introduces another module, a process termed a second level 
routine. 

Column two of Figure 21-3 shows the extent cf the ceding produced by 
the expansion of the macro instruction in column one. If the coding 
links to QTAM module, the module is presented in column three; if that 
module links to other modules, they are presented in column four. 

Storage requirements for a sharable module, or for a second level 
routine that is linked to more than once in the same partition are 
included only once. For example, the macro instructions DIRECT, EGA, 
and ROUTE all link to the same module, IJLQLK. If two or more of these 
macro instructions are used in the same message control program, the 
module is included only once. Similarly, if the same macro instruction 
is used more than once in the same program, storage is required for only 
the additional linkage because the module is included just once. 
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Macro Instruction 



In-line 
linkage 
or cede 
Note 5 



Sharable modules 



Name | Size 
1 



Second level 
routine 



Narre 



Size 



ARUMGTYP 
BREAKOFF 



16 



IJLQBO 



212 



CANCELM 
CHECKARU 



IJLQCM 



160 



70 + 

message 
text 



CHNGP 
CHNGT 



U2 



IJLQCP 
IJLQCT 



146 



IJLQFL 



26 



250 



CKREQ 
CLOSEMC 



10 



IJLQCR 
IJLQQT 



98 



474 



IJLQCL 



549 



COPYC 
COPYP 



24 



IJLQDC 
IJLQDP 



504 



34 



104 



IJLQFL 



COPYQ 
COPYT 



34 



IJLQDQ 
IJLQDE 



98 



30 



120 



COUNTER 
DATESTMP 



12 



IJLQDT 
IJLQLK 



60 



IJLQEX 



70 



DIRECT 
ENDRCV 



12 



104 



10 



Note 1 
IJLQEB 



ENDRCV (WTTA) 
ENDREADY 



16 



132 



80 



Note 1 
Note 1 
IJLQEA 



ENDSEND 
EGA 



10 



28 



100 



IJLQSH 
IJLQSK 
IJLQRG 
IJLQMT 
IJLQLK 



104 

76 

48 

60 

104 

Note 



EOB 



IJLQEB 



132 



Note 1 



EOBLC 



IJLQEC I 380 
X 



Note 1 



Figure 21-3. QTAM Storage Requireirents for Other 
(Part 1 of 5) 



Macro Instructions 
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Macro Instruction 




Note 5 




Name 


1 


Size 




Name | Size 




h 






1 






1 




1 




1 


4. 


1 






1 






1 




1 




1 


T 


1 




ERRMSG 








32 + 




IJIQER 




292 




IJLQLK 1 104 












message 




Note 1 






















text 
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GET 
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1 
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Segment 










h 


IJIQGS 


-+- 


454 


-+- 


j 


-^ 




Message 










IJLQGM 


472 














1" 





-+- 





-1- 


4 


-^ 




Record 












IJLQGR 




500 








1 






I 






1 




1 




1 


_ _x 


1 


1 






1 






1 




1 




1 


~r 


1 




GET (AUDIO) 


























Audio message 










IJLQGA 




324 










Audio and 


non- 
























audio messages] 








IJLQGB 




732 










Audio message 


^1 






















nonaudio 












IJLQGC 




760 










record 


























Audio message 


^1 






















nonaudio 


seg- 






















L, 


ment 


______ 


-+- 


,___. 


^ _^.^. 


-+- 


IJLQGD 


-+- 


714 


-+- 


4 


_\ 




INTERCPT 




1 




12 


1 


IJLQIT 


1 


140 


1 


L 










1 






1 




1 




1 


— r 




L. 


LOGSEG 





-+- 


.__. 


32 


-+- 





-+- 


Note 3 


-+- 


4 


_\ 


1 


LOGSEG (ARU) 


. — ^ — w 


-+- 


,__. 


26 


-+- 


IJLQLG 


-+- 


304 


-+- 


4 


,J 




LPSTART 




1 




28 


1 


Note 1 


1 




! _ 


_ 1 










1 






1 




1 




t 


1 — — 






MODE (C) 








14 




MODE (U) 1 


44 






















module 


&| 






IJLQSH 1 104 




h 






-+- 






-+- 


IJLQMM 


-+- 




-4- 


4 




MODE (U) 
















INITIATE 




l-- 




10 


-+- 


IJLQMI 


-+- 


18 


-4- 


4 

IJLQSH j 104 






PRIORITY 






10 


IJLQMP 


36 










h 







-+- 





-+- 




-+- 


4 


—\ 




CONVERSE 




h 




10 


-+- 


IJLQMC 
Note 1 


-+- 


384 


-+- 


4 






MOD2260 






4 








h 


MSGTYPE (C) 





-+- 





19 


-+- 


IJLQMT 


-+- 


60 


-4- 


4 

IJLQSH 1 104 


-^ 
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1 
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1 
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1 


X 


1 


1 
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4 
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1 
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1 
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56 
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i 
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i 
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Figure 21-3. QTAM — Storage Requirements for Other Macro Instructions 
(Part 2 of 5) 
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Macro Instruction 
PAUSE 



In-line 
Linkage 
or code 
Note 5 



Sharable Modules 



Narre 



Size 



Second Level 
routine 



Naire 



Size 



13 + 
insert 
chars. 



IJLQPZ 



360 



Note 1 



POLIIMIT 



12 



IJIQPL 



120 



POSTARU 



Note 1 



POSTRCV 



Note 1 



POSTSEND 



12 



Note 1 



PUT 

Segment 

Message ) 

Record 

PUT (AUDIO) 
|. 






IJLQPS 

IJLQPM 
|. 

IJLQPR 
IJIQPA 



520 



+ 



480 
370 






RCVHDR 



RCVSEG Note 4 



RELEASEM 



12 



IJLQRiVl 



230 



REPEAT 
REROUTE 



34 



Note 1 



26 



IJLQRR 
Note 1 



72 



IJIQLK 



104 



RETRIEVE 

DASD address 

By sequence 
number 

ROUTE 



14 
26 



IJIQRD 
IJLQRS 



124 
380 






IJLQRD 



124 






IJLQRC 



48 



IJLQIK 
IJLQSH 



104 
104 



SENDHDR 



16 



SENDSEG Note 4 



SEQIN 



I-- 

SEQOUT 

SKIP (CT) 



IJLQSI 



140 



IJLQSH 



104 



IJLQSO 



68 



IJLQEX 



70 






IJLQST 



48 



IJLQSH 



104 
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T T 

In-line 
linkage 
or code 
Note 5 



Macro Instruction 



Sharable modules 



Naire 



I Size 
4- 



Seccnd level 
routine 



Naire 



Size 



SKIP (S) 



8 + no. 

to be 

skipped 



IJLQSK 



76 



IJLQSH 



-+- 



104 



SOURCE 



IJIQSR I 128 



IJLQSH 



104 



STARTARQ 
STARTIN 



42 



IJLQSS 



300 



IJLQFL 



-+- 



12 



IJIQCL I 512 



IJLQFL 



STOPARU 
STOPLN 



42 



IJLQSS I 3 00 



IJLQFL 



■+- 



12 



IJLQCL I 512 



IJLQFL 



TIMESTMP 
TRANS 



IJLQTS I 198 



IJLQEX 



70 



■+- 



10 



IJLQTR 1 114+ 
I 266*T 



WRU 



I 
X. 



Figure 21-3. QTAM--Storage Requirements for Other Macro Instructions 
CPart 4 of 5) 



where: 

C = character operand specified (conditional) 
U = character operand null (unconditional) 

S = skip to and include designated character configuration 
CT = skip designated count of nonblank characters 
T = number of translation tables 

Translation tables arg: RCV1030, RCV1050, RCV1050F, RCV1060, RCV2260, RCV2740, 
RCV2740F, RCVARU, RCV83B3, RCV115A, RCVTWX, RCVITA2, RCVZSC3, SNB1030, SND1050, 
SND1060, SND2260, SNDITA2, SNDZSC3, SND2740, SND83B3, SND115A, SNCTWXE, and 
SNDTWXO 



Notes 



These delimiters or modules cause linkages to QTAM routines included in "Basic 
QTAM Logic Modules" listed earlier in this module under "Relocatable Library". 

If the macro instruction MSGTYPE, ROUTE, or SKIP (S) is used in the program, the 
storage estimate for IJLQMT, IJLORG, or IJLQSK, respectively, is not included in 
the storage estimate for EOA. 

Because the user defines his own DTFxx and xxMOD macros for his message log file, 
the size requirements cannot be specified here. Information to determine the 
storage requirements for the specific logging medium is given under the pertinent 
DTF and Module, i.e., DTFMT and MTMOD for Tape. Modules 7-18 contain storage 
requirements for declarative macros. 

Identifies entry point for RCVSEG and SENDSEG subgroups of LPS. 

The linkage requirements for OPEN, CLOSE, GET, and PUT are given in Module 1. 



Figure 21-3. QTAM — Storage Requirements for Other Macro Instructions (Part 5 of 5) 
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Modular Outline 



Partition Size 382 

Z^ssign Alternate Track Disk 382 

Core image library 382 

Phases 382 

Relocatable library 382 

Modules 382 

Link-Edit Statements 382 

Delete statements 382 

Assign Alternate Track Data Cell . . . .382 

Core Image Library 382 

Phases 382 

Relocatable Library 382 

Modules 383 

Link-Edit Statements 383 

Delete Statements 383 

Clear Disk 383 

Core Image Library 383 

Phases 383 

Relocatable Library 383 

Modules 383 

Link-Edit Statements 383 

Delete Statements 383 

Clear Data Cell 383 

Core Image Library 383 

Phases ...... .383 

Relocatable Library 383 

Modules 383 

Link-Edit Statements 383 

Delete Statements 383 

Copy Disk to Card .383 

Core Image Library 38 3 

Phases 384 

Relocatable Library 384 

Modules . ^ 384 

Link-Edit Statements 384 

Delete Statements 384 

Copy Disk to Disk 384 

Core Image Library 384 

Phases 384 

Relocatable Library 384 

Modules 384 

Link-Edit Statements 38 4 

Delete Statements 384 

Copy Disk or Data Cell to Tape 384 

Core Image Library 384 

Phases 384 

Relocatable Library 384 

Modules 384 

Link-Edit Statements 384 

Delete Statements 384 

Copy and Restore Diskette w ^ o ^ c = o384 

Core Image Library 384 

Phase 384 

Relocatable Library 385 

Module 385 

Link-Edit Statements 3 85 

Delete Statements 385 



Deblock Utility 385 

Core Image Library 385 

Phase 385 

Relocatable Library 385 

Modules 385 

Link-Edit Statements 385 

Delete Statements 385 

Past Copy Disk Volume 385 

Core Image Library (Integrated 

Version) 385 

Phases 385 

Relocatable Library (Integrated 

Version) 385 

Modules 385 

Link-Edit Statements (Integrated 
Version) 385 

Source Statement Library (Stand-alone 

Version) 385 

Macro . , . 385 

Statements to obtain Card Deck 

(Stand-alone Version) 385 

Delete Statements 385 

Initialize Disk 386 

Core Image Library . 386 

Phases 386 

Relocatable Library 386 

Modules 386 

Link-Edit Statements . .386 

Delete Statements 386 

Initialize Data Cell 386 

Core Image Library 386 

Phases 386 

Relocatable Library 386 

Modules 386 

Link-Edit Statements 386 

Delete Statements 386 

Initialize Tape 386 

Core Image Library 386 

Phase 386 

Relocatable Library 386 

Modules 386 

Link-Edit Statements 386 

Delete Statements 386 

Restore Card to Disk 387 

Core Image Library 387 

Phase 387 

Relocatable Library 387 

Modules 387 

Link-Edit Statements 387 

Delete Statements 387 

Restore Tape to Disk or Data Cell . . .387 

Core Image Library 387 

Phase 387 

Relocatable Library 387 

Modules 387 

Link-Edit Statements 387 

Delete Statements 387 
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VTOC Display 387 

Core Image Library 387 

Phase 387 

Transient 387 

Relocatatle Library 387 

Modules (BJS) 387 

Link-Edit Statements, 

Non-Multiprograiriring Systeir . . . .387 

Delete statements, 

Non-Multiprograiriring Systeir . . . .387 

Modules (MPS) 387 

Link-Edit Statements, 

Multiprogramming System 388 

Delete Statements, 

Multiprogramming System 388 

Page Data Set Dump 388 

Core Image Library 388 

Phase 388 

Relocatable Library 388 

Module 388 

Link-Edit Statements 388 



Modular Index 



assign alternate track data cell 
core image library blocks 388 
delete statements 389 
link-edit statements 389 
module names 389 
modules, number of 388 
phase names 388 
phases, number of 388 

assign alternate track disk 

core image library blocks 388 
delete statements 388 
link-edit statements 388 
module names 38 8 
modules, number of 388 
phase names 38 8 
phases, number of 388 



clear data cell 

core image library blocks 389 
delete statements 389 
link-edit statements 389 
module names 3 89 
modules, number of 388 
phase names 389 
phases, number of 388 

clear disk 

core image library blocks 388 
delete statements 388 
link-edit statements 389 
module names 389 
modules, number of 388 
phase names 389 
phases, number of 388 



Copy disk to disk 

core image library blocks 388 
delete statements 390 
link-edit statements 390 
module names 390 
modules, number of 388 
phase names 390 
phases, number of 388 

copy and restore diskette 

core image library blocks 3 88 
delete statements 391 
link-edit statements 391 
module names 391 
modules, number of 388 
phase names 39 
phases, number of 388 

copy disk or data cell to tape 
core image library blocks 388 
delete statements 390 
link-edit statements 390 
module names 390 
modules, number of 3.88 
phase names 390 
phases, number of 388 

copy disk to card 

core image library blocks 388 
delete statements 390 
link-edit statements 390 
module names 390 
modules, number of 388 
phase names 390 
phases, number of 38 8 
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deblock 

core image library blocks 38 8 
delete statements 391 
link-edit statements 391 
module names 391 
modules, number of 3 88 



fast copy disk volume 391 

source statement library 391 
macro 391 

to obtain executable card deck 
delete statements 391 



initialize data cell 

core image library blocks 38 8 
delete statements 392 
link-edit statements 392 
module names 39 2 
modules, number of 3 88 
phase names 39 2 
phases, number of 388 

•initialize disk 

core image library blocks 38 8 
delete statements 392 
link-edit statements 39 2 
module names 392 
modules , number of 388 
phase names 392 
phases, number of 388 

initialize tape 

core image library blocks 3 88 
delete statements 392 
link-edit statements 392 
module names 39 2 
modules, number of 388 
phase names 392 
phases, number of 388 



391 



page data set dump 

core image library blocks 388 
link-edit statements 39 4 
module name 394 
modules, number of 388 
phase names 39 4 
phases, number of 388 

restore card to disk 

core image library blocks 388 
delete statements 39 3 
link-edit statements 39 3 
module names 39 3 
modules, number of 388 
phase names 39 3 
phases, number of 388 

restore tape to disk or data cell 
core image library blocks 388 
delete statements 393 
link-edit statements 39 3 
module names 39 3 
modules, number of 388 
phase names 39 3 
phases, number of 388 



transients , IBM-supplied 
$$BLVTOC 39 3 



VTOC display 

core image library blocks 388 
delete statements 393, 394 
link-edit statements 393, 394 
module names 39 3 
modules, number of 388 
phase names 39 3 
phases, number of 388 
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The library requirements for the Utility prcgrarrs are the following; 



Component 

Assign Alternate Track Disk 

Assign Alternate Track Data Cell 

Clear Disk 

Clear Data Cell 

Copy Disk to Card 

Copy Disk to Disk 

Copy Disk or Data Cell to Tape 

Copy and Restore Diskette 

Deblock Utility 

Initialize Disk 

Initialize Data Cell 

Initialize Tape 

Restore Card to Disk 

Restore Tape to Disk or Data Cell 

VTOC Display 

Transient 
Page Data Set Dump (PDSDM) 
Fast Copy Disk Volume 



Libraries : 
Co re I mage B^locatable Source Statement 
Phases Blocks Modules Blocks Macros Blocks 



5 


41 


6 


90 


5 


26 


6 


69 


3 


7 


4 


34 


3 


7 


4 


32 


2 


11 


3 


51 


2 


13 


3 


57 


2 


11 


3 


52 


1 


19 


1 


71 


1 


16 


2 


63 


4 


25 


5 


10 


4 


18 


5 


65 


1 


5 


2 


22 


1 


7 


2 


32 


1 


8 


2 


34 


1 


5 


4 


32 


1 


1 






1 


11 


1 


40 


2 


49 


a 


56 



PARTITION_SIZE 

10,240 bytes 

Note: To delete all utilities, use the 
following statement. 

DELETR IJW.ALL 



Link-Edit Statements 



INCLUDE IJWATD 
// EXEC LNKEDT 



Delete Statements 



Assign Alternate Track Disk 

CORE IMAGE LIBRARY 
Phases 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJWATD 
IJWATDl 
IJWATD2 
IJWATD 3 
IJWATD 4 
IJWATD5 



ALTDK 
ALTDK2 
ALTDK3 
ALTDK4 
ALTDK 5 



RELOCATABLE LIBRARY 
Modules 



IJWATD 

IJWATDl 

IJWATD 2 

IJWATD3 

IJWATD4 

IJWATD5 



Assign Alternate Track Data Cell 



CORE IMAGE LIBRARY 
Phases 



ALTDC 

ALTDC2 

ALTDC3 

ALTDC4 

ALTDC5 



RELOCATABLE LIBRARY 
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Modules 



Eelete Statements 



IJWATM 

IJWATMl 

IJWATM2 

IJWAT^43 

IJWATM4 

IJWATM5 



DELETE IJWCCD 

EELETR IJWCCDl 

DELETR IJWCCD2 (See note) 

DELETR IJWCCD3 (See note) 

Note: Only if CLEAR DATA CELL net 
performed. 



Link-Edit Statements 



INCLUDE IJWATM 
// EXEC LNKEDT 



Delete Statements 



Clear Data Cell 



CORE IMAGE LIBRARY 



Phases 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJWATM 

IJWATMl 

IJWATM2 

IJWATM3 

IJWATM4 

IJWATM5 



CLRDC 

CLRDC2 

CLRDC3 



RELOCATABLE LIBRARY 
Modules 



Clear Disk 

CORE_IMAGE_LIBRARY 
Phases 



IJWCCM 
IJWCCMl 
IJWCCD2 
IJWCCD3 



Link-Edit Statements 



CLRDK 

CLRDK2 

CLRDK3 



INCLUDE IJWCCM 
// EXEC LNKEDT 



RELOCATABLE LIBRARY 
Modules 



IJWCCD 
IJWCCDl 
IJWCCD2 
IJWCCD3 



Delete Statements 



DELETR IJWCCM 

DELETR IJWCCMl 

EELETR IJWCCD2 (See note) 

DELETR IJWCCD3 (See note) 



Note; Cannot delete if already deleted by 
CLEAR DISK. 



Link-Edit Statements 



INCLUDE IJWCCD 
// EXEC LNKEDT 



Copy Disk to Card 



CORE IMAGE LIBRARY 
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Phases 



Delete Statements 



CDKCD 
CDKCD2 



RII;OCATABLE_LIBRARZ 
Modules 



IJWCDC 

IJWCDCl 

IJWCDC2 



Link-Edit Statements 



INCLUDE IJWCDC 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 



Delete Statements 



DELETR IJWCDD 
DELETR IJWCDDl 
DELETR IJWCDD 2 



Copy Disk or Data Cell to Tape 



CORE IMAGE LIBRARY 



Phases 



CDKTP 
CDKTP2 



RELOGATAELE_LIBRARY 
Modules 



DELETR IJWCDC 
DELETR IJWCDCl 
DELETR IJWCDC2 



IJWCDT 
IJWCDTl 
IJWCDT 2 



Copy Disk to Disk 

CORE_IMAGE_LIBRARY 
Phases 



Link-Edit Statements 



INCLUDE IJWCDT 
// LBLTYP NSDCnn) 
// EXEC LNKEDT 



CDKDK 
CDKDK2 



Delete Statements 



RELOCATABLE LIBRARY 
Modules 



DELETR IJWCDT 
DELETR IJWCDTl 
DELETR IJWCDT 2 



IJWCDD 

IJWCDDl 

IJWCDD2 



Link-Edit Statements 



INCLUDE IJWCDD 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 



Copy and Restore Diskette 

CORE IMAGE LIBRARY 
Phase 

CRDR 
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RELOCATABLE LIBRARY 



Module 



IJWCRD 



Link-Edit Statements 



PHASE CRDR,S 
INCLUDE IJWCRD 
// EXEC LNKEDT 



Delete Statertients 
DELETR IJWCRD 

Deblock Utility 

925E_IMAGE_LIBRARY 
Phase 

DSTRB 

RELgCATABLE_LIBRARY 
Modules 



IJWDST 
IJWDSTl 



Link-Edit Statements 



INCLUDE IJWDST 
// LBLTYP TAPE 
// EXEC LNKEDT 



Delete Statements 



DELETR IJWDST 
DELETR IJWDSTl 



Fast Copy Disk Volume 



CORE IMAGE LIBRARY (INTEGRATED VERSION) 



Phases 



FCCPY 
FC0PY2 



RELOCATABLE LIBRARY (INTEGRATED VERSION) 
Modules 



IJWDFC 
IJWDFCl 
IJWDFC2 
IJFUZZZZ 



Iink-Edit_Statements (Integrated Versicn) 



// OPTION CATAL 

INCLUDE IJWDFC 
// LBLTYP TAPE 
// EXEC LNKEDT 



SOURCE STATEMENT LIBRARY (STAND-ALONE 
VERSION) 

Macro 



Z.FASTCOPY 



Statements to_obtain Card_Deck (Stand-alone 

Version) 



// EXEC SSERV 

PUNCH Z.FASTCOPY 
/* 



Delete Statemsni 



DELETR IJWDFC 
DELETR IJWDFCl 
DELETR IJWDFC 2 
DELETR IJFUZZZZ 
DELETS Z.FASTCOPY 
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Initialize Disk 



Modules 



CQRE_IMAGE_LIBRARY 
Phases 



INTDK 
INTDK2 
INTDK 3 
INTDKtt 



EELOCATABLE_LIBRARY 
Modules 



IJWIND 

IJWINDl 

IJWIND2 

IJWIND3 

IJWIND4 



IJWINM 

IJWINMl 

IJWINM2 

IJWINM3 

IJWINMU 



Link-Edit Statements 



INCLUDE IJWINM 
// EXEC LNKEDT 



Delete Statements 



DELETE 
DELETR 
DELETR 
DELETR 
DELETR 



IJWINM 
IJWINMl 
IJWINM 2 
IJWINM3 
IJWINM4 



Link-Edit Statements 



INCLUDE IJWIND 
// EXEC LNKEDT 



Delete Statements 



DELETR 
DELETR 
DELETR 
DELETR 
DELETR 



IJWIND 

IJWINDl 

IJWIND2 

IJWIND3 

IJWIND4 



Initialize Tape 

CORE_IMAGE_LIBRARY 
Phase 

INTTP 

RELOCATABLE LIBRARY 
Modules 



Initialize Data Cell 



IJWINT 
IJWINTl 



CORE_IMAGE_LIBRARY 
Phases 



INTDC 
INTDC2 
INTDC3 
INTDCU 



RELOCATABLE LIBRARY 



Link-Edit Statements 



INCLUDE IJWINT 
// EXEC LNKEDT 



Delete Statements 



DELETR IJWINT 
DELETR IJWINTl 
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Restore Card to Disk 



Delete Statements 



CORE IMAGE LIBRJ^RY 
Phase 



DELETR IJWRTD 
DELETR IJWRTDl 



RCDDK 



VTOC Display 



RELgCATABLE_LIBRARY 
Modules 



CORE IMAGE LIBRZ^RY 
Phase 



IJWRCD 
IJWRCDl 



I VTOC 



Link-Edit Statements 



INCLUDE IJWRCD 
// LBLTYP NSD(nn) 
// EXEC LNKEDT 



Transient 



$$BLVTOC 



Note; $$EIVTOC is cataloged into the core 
image library along with the VTOC program. 



Delete Statements 



DELETR IJWRCD 
DELETR IJWRCDl 



Restore Tape to Disk or Data Cell 



CORE IMAGE LIBRARY 
Phase 

RTPDK 



RELOCATABLE LIBRARY 
Modules (BJS) 



IJWLTVB 
IJWLTVT 
IJWLTVl 



Link-Edit Statements ^ Non-Multiprogramming 
System 



INCLUDE IJWLTVB 
// LBLTYP TAPE 
// EXEC LNKEDT 



RELOCATABLE LIBRARY 
Modules 



Delete St ate ments^ Ncn-Multiprcgramming 
System 



IJWRTD 
IJWRTDl 



DELETR IJWLTVB 
DELETR IJWLTVM 



Link-Edit Statements 



Modules (MPS) 



INCLUDE IJWRTD 
// LBLTYP NSD(IO) 
// EXEC LNKEDT 



IJWLTVM 
IJWLTVT 
IJWLTVl 
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Link-Edit Statements ^ Multiprograiriring RELOCATABLE LIBRARY 
System 

Module 
INCLUDE IJWLTVM 
// EXEC LNKEDT 

IJEPDSDM 

Deleters tatenients^_Multi2£23£§:S:Ei£3_§Y5i£50 

DELETR IJWLTVM Link-Edit Statements 

DELETR IJWLTVB 

I INCLUDE IJBPDSDM 

Page Data Set Dump // lbltyp tape (see Note) 

// exec lnkedt 

core_image_library 

Note : Required only if tape is to be used 
Phase for intermediate storage of the page data 

set dump. 

PDSDM 
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Modular Outline 



Partition Size 390 

Cere Iirage Library 390 

Phases 390 

Relocatatle Library 390 

Modules 390 

Link-Edit Staterrents 397 

Delete Statements 397 

Source Stateirent Library ...... .398 

GENERAL INDEX BY MODULE .3 99 

Relocatable Library 399 

Modules 399 

Link-Edit Staterrents 400 

Delete Statements ^tOO 

Source Statement Library UOO 
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PARTITIpN_ 


SIZE 












EREPRETV 
EREPSHRT 


10.240 byt 


SS. 










1 


EREPSHRU 
EREPSMCP 
EREPSMCR 
EREPSMCU 
EREPSMDA 
EREPSMDK 


CORE_IMAGE 


LIBRARY 










EREPSMDl 
















EREPSMES 
















EREPSMTD 
EREPSMTP 






r — 

1 


Phases 


~T — 

1 


Blocks 


1 


r 




--+- 




-+- 





-■1 


EREPSMTR 


1 Transients 


1 


1 


1 


1 


1 


EREPSMTl 


L 




1 




L 




_j 


EREPSMUR 
EREPSMUl 


r 

1 Phases 




— f 

1 


76 


— T — 

1 


204 


t 

1 


L 




X. 




_JL 




_ J 


EREPSPCL 
EREPTES 






























EREPTPEl 


Modular Outline 












EREPUCCM 
















EREPUNIT 


Transients 














EREPUOLD 
EREP145A 


$$BSDRUP 














EREP145E 
EREP145C 
EREP145D 
EREP24 00 


Phases 














EREP2715 
EREP3211 
EREP333X 


EREP 














EREP333Y 


EREPADPT 














EREP 33 3Z 


EREPASTA 














EREP 33 3 


EREPCCH 














EREP3340 


EREPCCHC 














EREP334X 


EREPC125 














EREP334Y 


EREPC135 














EREP334Z 


EREPC145 














EREP3410 


EREPDOLD 














EREP3420 


EREPEDCP 














EREP3500 


EREPEDCR 












1 


EREP3540 



EREPEDCU 

EREPEDDA 

EREPEDDK 

EREPEDES 

EREPEDDl 

EREPEDIT 

EREPEDTD 

EREPEDTP 

EREPEDTR 

EREPEDTl 

EREPEDUR 

EREPEDUl 

EREPEDXl 

EREPEOD 

EREPESPT 

EREPESTR 

EREPESWK 

EREPHIST 

EREPIPL 

EREPMCAR 

EREPMCRC 

EREPMNTR 

EREPM145 

EREPRDE 



RELOCATABLE LIBRARY 



Modules I Blocks | 



I I 



76 



-4- 



863 



•^ 



Modules 



IJEEREP 

IJBEADPT 

IJBEASTA 

IJBECALA 

IJBECALB 

IJBECALC 

IJEECALD 

IJBECCH 

IJEECCHC 
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IJBEC125 

IJBEC135 

IJBEC145 

IJBEEDDK 

IJBEDOLD 

IJBEEDCP 

IJBEEDCR 

IJBEEDCU 

IJBESD.DA 

IJBEEDDl 

IJBEEDES 

IJBEEDIT 

IJBEEDTD 

IJBEEDTP 

IJBEEDTR 

IJBEEDTl 

IJBEEDUR 

IJBEEDUl 

IJBEEDXl 

IJBEEOD 

IJBEESPT 

IJBEESTR 

IJBEESWK 

IJBEHIST 

IJBEIPL 

IJBEMCAR 

IJBEMCRC 

IJBEMNTR 

IJBEM14 5 

IJBERDE 

IJBERETV 

IJBESHRT 

IJBESHRU 

IJBESMCP 



IJEESMCR 
IJBESMCU 
IJEESNDA 

I IJEESNDK 
IJBESMDl 
IJBESNES 
IJEESMTD 
IJBESNTP 
IJBESMTR 
IJEESMTl 
IJBESMUR 
IJBESMUl 
IJBESPCL 
IJBETES 
IJBETPEl 
IJEEUCCM 
IJBEUNIT 
IJEEUOLD 
IJBE145A 
IJBE145B 
IJBEmSC 
IJEE145D 
IJBE2400 
IJBE2715 
IJBE3211 
IJBE333Z 
IJBE3330 

I IJBE334Z 

I IJBE3340 
IJBE3U10 
IJBE3420 
IJBE3500 

I IJBE3540 



Link-Edit Statements 



PHASE EREP,S+80* 

PHASE EREP,+0 

INCLUDE IJBECALA 
// EXEC LNKEDT 

INCLUDE IJBECALB 
// EXEC LNKEDT 

INCLUDE IJBECALC 
// EXEC LNKEDT 

INCLUDE IJBECALD 
// EXEC LNKEDT 

INCLUDE IJBERDE 
// EXEC LNKEDT 



(For a non-rrultiprogramming systerr) 
(For a multiprogramming system) 
(Monitor) 

(Edit/Select Retrieval) 

(Summary) 

(Tape Error Statistics) 

(RDE Summary**) 



Choose 
one 



* 80 byte area reserved for tape label processing. This procedure does 
away with the necessity of including a // LBLTYP card. 

** The summary function will supply meaningful information only if 
ERRLOG=RDE is specified during system generation. 



Delete Statements 



DELETR IJBEREP , IJBEADPT , I JBEASTA , e tc , 
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SOURCE STATEMENT LIBRARY 

r T 1 

I Macros 1 Blocks | 
y + __^ 

I I 7 I 187 I 

L X J 



Macros 



E.MAPCCB 

E.MAFCOMR 

E.MAPERPIE 

E.MAPLOWC 

E.MAPPIB 

E.MAPPUB2 

E.MAFRFTAB 
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AB 1 

ABD 3 

ACANCEL 1 

Access Method Services (AMS) 17 

ACCOUNT 2 

ADD 1 

adding unique entries using merge 

function 1 
ADDITR 2 
ALIGN 1 
ALLOC 1 
ALLOCR 1 
allocate 1 

allocating library sizes 1 
alternate track assignment disk 22 

secondary storage requirements 1 
alternate track assignment data cell 22 

secondary storage requirements 1 
AMS 17 
AP 1 
ASCII 1 
ASL 3 
assembler 18 

secondary storage requirements 1 
ASSGN macro 1 
Attention routines , Initiators , 

Terminators 1 
AUTOSTR 2 



background partition storage requirements 

1 
back-up tape, creation of 1 
back-up tape, restoring 1 
basic QTAM logic modules 21 
BGPGR 1 
BGR 1 
BLKMPX 1 

Block Multiplex Channel Support 1 
BMPX 1 
BSCLNS 1 
BTAM 21 

secondary storage requirements 1 
BTMOD (BTAM logic module) , size of 20 
BTMOD generation 2 
bypass initialize disk 1 
BUFSIZE 1 



CAP 3 

card to disk 22 

secondary storage requirements 1 
CBF 1 
CCHAIN 1 
CDMOD 1 

V> JL> JL^l O L) 

(card module names for compilers) 
real storage requirements 7 

CHAN 1 

CHANQ 1 

CHANSW 1 

CHARSET 1 

Checkpoint/Restart 1 



CHUN 1 

clear data cell 22 

secondary storage requirements 1 
clear disk 22 

secondary storage requirements 1 
command chaining (CCHAIN) 1 
common librarian modules 1 
compiler IOCS modules 7 
component identification 

core image library 1 

relocatable library 1 

source statement library 1 
components shipped with transients 1 
computing the size of a supervisor, 1 
CONFG macro 1 
console buffering 1 
copy and restore 1 
copy and restore diskette 22 
copy disk or data cell to tape 22 

secondary storage requirements 1 
copy disk to card 22 

secondary storage requirements 1 
copy disk to disk 22 

secondary storage requirements 1 
copy system disk to tape 1 
copying selectively to merge libraries 
core image library 

assembler 18 

components 1 

CORGZ 1 

CSERV 1 

directory 1 

DOC 1 

DSERV 1 

DUMPGEN 1 

EREP 1 

ESERV 1 

IBM 3211 printer support 1 

IBM-supplied 1 

IPL 1 

job control 1 

linkage editor 1 

MAINT 1 

MCAR/CCH 1 

OLTEP 17 

PDAIDS 1 

PSERV 1 

RMS 1 

RSERV 1 

SSERV 1 

Standard system dump 1 

supervisor nucleus, (32K) 1 

T/P, BTAM 20 

T/P, QTAM 21 

transients (see transients) 

translating system dump 1 

utilities (systeni) 2? 
CORGZ 1 
creating a back-up of your generated 

system volume 1 
creating a third library from existing 

libraries 1 
CSERV 1 
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D2311 1 




D2314 1 




D2321 1 




D3330 1 




D3340 1 




D2400 1 




D3410 1 




D3420 1 




D3540 1, 2 




D3881 1 




D3886 1 




DAMOD 




(direct access module names for 


compilers) 


7 


real storage 


requirements 8 


DASDFP 1 




DATAFIL 2 




DATE 1 




DBLK 2 




DCC 1 




DEC 1 




DECK 1 




DELETECL 1 




DELETERL 1 




DELETESL 1 





deleting entries and merging libraries 1 

DELUNSD 3 

DELUSED 3 

device I/O modules requirements (QTAM) 21 

DFTRMLST (define the terminal list BTAM) 

20 

table requirements 20 
diagnostics 18 
DIAG 2 
DIMOD (device independent module names for 

compilers) 7 

real storage requirements 1 
directory capacities, system 1 
Disconnect Command Chaining (DCC) 1 
disk ERP 1 
DISK 1 

DI.SK (POWER parameter) 2 
disk to card 22 

secondary storage requirements 1 
disk to disk 22 

secondary storage requirements 1 
disk work files 
assembler 18 
modules 7 
distribution 1 
DOC 1 
DPD macro 1 
DSERV 1 
DTFBT (define the file BTAM) , size of 

table 20 
DTFBTND (define the file end BTAM) , size 

of table 21 
DTFCD (define the file card) , size of 

table 1 
DTFCN (define the file console) 1 
DTFDA (define the file direct access 

device) 8 
DTFDI (define the file device independent 

system units) 1 
DTFDU (define the file: diskette file) 9 
DTFIS (define the file indexed sequential) 

10 



DTFMR (define the file magnetic character 

reader) 11 
DTFMT (define the file magnetic tape) , 

size of table 12 
DTFOR (define the file optical reader) . 

size of table 13 
DTFPH (define the file physical IOCS) , 

size of table 1 
DTFPR (define the file printer) , 

size of table 1 
DTFPT (define the file paper tape) 15 
DTFQT (define the file QTAM) 21 
DTFSD (define the file sequential DASD) 

16 
DTFSR (define the file serial device) 1 
dumps 1 

DUMOD (disk unit module) 9 
DUMP 1 
DUMPGEN 1 
DVCGEN macro 1 
DVCTYP 1 



ECPREAL 1 
EDECK 1 
EMA 3 
EMANAME 3 
EMATA 3 
EMATSN 3 
EMATYPE 3 
EMB 3 
EMBNAME 3 
EMBTA 3 
EMBTSN 3 
emulator 1 

linkage edit statements 4-6 

sample problems 4-6 
emulators 

module names 4-6 

module sizes 4-6 
modules, number of 4-6 
end of supervisor macro instruction, 

SEND 1 
environmental recording, editing and 

printing program (see ERP) 
EREP 21,1 
ERRLOG 1 
error statistics 

by tape volume 1 

2495 Tape Cartridge Reader 1 
ERRQ 1 
ERRS 1 
ESERV 1 
EU parameter 1 
EVA parameter 1 
examples 1 
EXIT 1 
E20 3 
E20NAME 3 



fast copy disk volume utility 22 
file names and logical unit ident. for 
merge 1 
FOPT macro 1 
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F1,F2,F3,F4 1 
FlPGR 1 
F2PGR 1 
F3PGR 1 
F4PGR 1 
F4R,F3R,F2R,F1R 



general library updating techniques 
general system generation procedures 
generated system volume, creating a 

backup of 1 
GETVIS 1 
GETVIS area in SVA 1 



hard-copy file (Model 125) 



I/O configuration, sysgen examples 
IBM-supplied libraries 1 
IBM DOS/VS distribution 1 
IBM 2314 work file requirements 1 
IBM 3330 work file requirements 1 
IBM 520 3 buffer load (IPL) 1 
IBM 3211 buffer load (IPL) 1 
IBM 3203 buffer load (IPL) 1 
initialize and restore programs 

bypass initialize disk 1 

initialize disk 1 

restore IBM tape to disk 1 
initialize data cell 22,1 
initialize disk messages 1 
initialize disk 22,1 
initialize tape 22,1 
IOCS module sizes 

BTAM (BSC) 20 

BTAM (start-stop) 20 

BTAM ( trans 1. tables) 20 

compilers 7 

disk work files 7 
IOCS 

(distr. program) 

compilers 7 

tape work files 7 



messages 

modules , 

modules , 
lODEV 1 
lOTAB macro 1 
IPL 1 
IPTADDR 3 
ISMOD 7,10 
IT parameter 1 
IVP 

creation of IVP state II jobstream 

operating instructions 3 

optional SCP functions 3 

set-up requirements 3 

standard SCP functions 3 
IVPGEN macro 

assembly 3 

execution 3 

parameters 3 



JIB 1 

job accounting interface 

job control 1 

JOBSEP 2 



librarian programs 1 
library block size 1 
library sizes 1 
LINES 1 
LINETAB 2 

linkage editing or deleting IBM 
components 1 
linkage editor 1 
LIST 1 
listings 1 
LISTX 1 
LOG 1 
LSERV 1 



machine requirements 1 

macro work file needs, assembler 1 

macro instructions for generating a 

supervisor 1 
macros, IBM-supplied 
ACB 17 



ALLOC 


1 


ALLOCR 


1 


ANUM 4 


.5 


ARUMGTYP 


21 


AS 20 




ASCTR 


21 


ASLIST 


20 


ASSGN 


1 


ASYSCOM 


1 


ATTACH 


1 


BDIL 4 


,5 


BDYBOX 


1 


BIFLAG 


4,5 


BREAKOFF 


21 


BTBONLT 


20 


BTBTEIH 


20 


BTBTFIX 


20 


BTBTFREE 


20 


BTBTROD 


20 


BTBTRSCH 


20 


BTCEMODE 


20 


BTCKID 


20 


BTCONST 


20 


BTCSE 


20 


BTCTUPT 


20 


BTMCKID 


20 


BTOLTCMP 


20 


BTOLTIH 


20 


BTONLAP 


20 


BTONLOA 


20 


BTRLBF 


20 


BTRQBF 


20 


BTTRANS 


20 


BTMOD 


20 


BTRD 20 


BTRWC 


20 


BTWAIT 


20 


BUFARU 


21 


BUFFER 


21 


CALL 1 




CANCEL 


1 


CCB 1 




CDLOAD 


1 


CDMOD 


1,7 


CHECK 


1 
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macros, IBM-supplied (Cont.) 
CHECKARU 21 
CHGNTRY 21 



CHKPT 

CHNG . 

CHNGP 

CHNGT 

CKREQ 

CLOSE 

CLOSEMC 

CLOSER 

CNTRL 

COMP 

COMRti 

CONFG 



21 
21 
21 
1 

1 

1 

4,5 

1 

1 



21 



CONFIGUR 

CONTROL 

COPYC 

COPYP 

COPYQ 

COPYT 

COUNTER 

CRTAEX 

CRT AWT 

CRT GEN 

CRTIO 

CRTSAV 

STLTBL 

CRTGROUP 

CTRL I ST 



20 
20 



21 



21 
21 
21 
21 

1 
1 

1 



1 
2i 

20 
20 

20 



CTRSCHED 
DAMOD 7 , 8 
DAMODV 8 
DATESTMP 21 
DBIB 4,5 
DDTF 4 , 5 
DDUB 4 , 5 
DECCB 5 
DELETEuL 1 
DELETERL 1 
DELETESL 1 
DEQ 1 
DEQB 1 
DETACH 1 
DEULIST 20 
DFR 14 
DFTMRLST 20 
DIIQCR 4 
DIIRCR 5 
DIL 4,5 
DIMOD 1 , 7 
DIRECT 21 
DISEN 11 
DISPGUID 20 
DLINT 14 
DLINTIN 14 
DOSCHLV 1 
DPD 1 
DRMOD I A 
DSKIO 2 
DSPLY 13 
DSUB 4,5 
DTFBG 1 
DTFBT 20 
DTFCD 1 
DTFCN 1 
DTFDA 8 



DTFDI 

DTFDR 

DTFDU 

DTFEN 

DTFIS 

DTFMR 

DTFMT 

DTFOR 

DTFPH 

DTFPR 

DTFPT 

DTFQT 

DTFSD 

DTFSR 

DUMODFI 

DUMODFO 

DUMP 

DVCGEN 

EMCNSL 

EMDISK 

EMEND 

EMPNCH 

EMPTR 

EMRDR 

EMSPLOl 

EMSPLOIS 



1 



1 

14 

9 

1 

10 

11 

12 

13 

1 

1 

1,15 

21 

16 

1 

9 

9 

1 

4,5 
4,5 
4,5 

4,5 
4,5 
4,5 
4 
4 



EMSPLIO 5 

EMSPLIOS 5 

EMSUP 4 , 5 

EMTAPE 4 , 5 

EMUDI 5 

EMULATOR 4 

EMVERIFY 

EM1403 

EM1412 

EM20CHK 

EM20CONV 

EM20CPU 

EM20DI 

EM20END 

EM20MESS 

EM20PRHD 

EM20SYS 

EM20VRIF 

EM2152 

EM2203 

EM2311 

EM2400 

EM2501 

EM2520 

EM2560 

ENDFL 

ENDRCV 

ENDREADY 

ENDREQ 

ENDSEND 



5 
4,5 
6 
6 
6 

6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
6 
10 
21 

21 
17 
21 



1 

1 
21 
21 



ENQ 

ENQB 

EOA 

EOB 

EOBLC 

EOJ 

ERASE 

ERET 1 

ERRMSG 21 

ESETL 10 

EXCP 1 

EXIT 1 



21 



17 
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macros IBM-supplied (Cont.) 
EXLST 17 



FASTCOPY 


22 


FCEPGOUT 


1 


FEOV 1 




FEOVD 1 




FETCH 1 




FOPT 1 




FREE 1 




FREEVIS 


1 


GDUAS 20 


GDULIST 


20 


GDUTRANS 


20 


GENCB 17 


GET 1 




GETIME 


1 


GETVIS 


L 


IIQBR 4 




IIQCR 4 




IIQDS 4 




IIQEI 4 




IIQID 4 




IIQIU 4 




IIQOJ 4 




IIQUR 4 




IIRCR 5 




IIRDCC 5 


IIREI 5 




IIRID 5 




IIRIU 5 




IIROJ 5 




IISCR 6 




IISDC 6 




IISEDB 6 


IJLQDEQU 


21 


IJLQDSCT 


1,21 


IJLQTSVC 


1,21 


IKQCBl 17 


IKQCB2 17 


IKQERI^IAC 


1 / 


INTERCPT 


21 


lOINTER 


1 


lOTAB 1 




ISMOD 7 


10 


IVPASLC 


18 


IVPASLS 


18 


IVPEMAC 


4 


IVPEMBC 


4 


IVPE20C 


6 


IVPOLTC 


19 


IVPPWRC 


2 


IVPUTLC 


22 


IVPUTLS 


22 


JDUMP 1 


LBRET 1 




LCBD 21 




LF.RB 7.() 




LERPRT 20 


LINE 21 




LINETBL 


21 


LINKEDIT 


1 


LIST 21 




LITE 11 




LOAD 1 




LOGSEG 21 


LOPEN 20 




LPSTART 


21 



MAPCCB 1,23 


MAPCOMR 1,23 


MAPEREIB 1,23 


MAPLOWC 1,23 


MAPPIB 1,23 


MAPPUB2 1,23 


MAPRFTAB 1,23 


MCPU 4 , 5 


MCRAS 1 


MCRl 11 


MCR2 11 


MIO 4,5 


MODCB 17 


MODE 21 


MRMOD 11 


MSGTYPE 21 


MTMOD 7,12 


MULDIV 4 


MVCOM 1 


NOTE 1 


ONLTST 20 


OPCTL 21 


OPEN 1 


OPENR 1 


OPTION 21 


ORDC 13 


ORJT 13 


ORMOD 13 


PAGE IN 1 


PARAMNUM 20 


PARMLIST 20 


PAUSE 21 


EDUMP 1 


PFIX 1 


PFREE 1 


PIOCS 17 


POINT 17 


POINTR 1 


POINTS 1 


POINTW 1 


POLL 21 


POLLIMIT 21 


POST 1 


POSTARU 21 


POSTRCV 21 


POSTSEND 21 


POWER 2 


POWERBUF 2 


POWERRES 2 


POWERSUP 2 


PREFIXD 21 


PRMOD 1 , 7 


PROCESS 21 


PRTOV 1 


PTMOD 15 


PUT 1 


DnrpD T_ 


QCBD 21 


RGB 1 


RCVHDR 21 


RCVITA2 21 


RCVSEG 21 


RCVZSC3 21 


RDLNE 13 
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macros , IBM' 


-supplied 


(Cont.) 


READ 1 






REALAD 


1 




RELBUF 


20 




RELEASE 


1 




RELPAG 


1 




RELEASEM 


21 




RELSE 


1 




REPEAT 


21 




REQBUF 


20 




REROUTE 


21 




RESCN 


13 




RESETPL 


20 




RETRIEVE 


21 




RETURN 


1 




RJBLKLST 


2 




RJBTMOD 


2 




RJEBLK 


2 




RJUSERS 


2 




RMSRTAB 


20 




ROUTE ; 


21 




RUNMODE 


1 




RPL 17 






SAMP 3 2 7L 


20 




SAMP 3 2 VR 


20 




SAVE 1 






SCANREQ 


18 




SDMOD 


1,1 




SDMODFI 


16 




SDMODFO 


16 




SDMODFU 


16 




SDMODUI 


16 




SDMODUO 


16 




SDMODUU 


16 




SDMOD VI 


16 




SDMODVO 


16 




SDMODVU 


16 




SDMODW 


16 




SDRTAB 


20 




SEND 1 






SENDHDR 


21 




SENDSEG 


21 




SEOV 1 






SEQIN ; 


21 




SEQOUT 


21 




SETDEV 


14 




SETFL ; 


LO 




SETIME 


1 




SETL 10 




SETPFA 


1 




SGAM 1 






SGCCWT 


1 




SGDFCH 


1 




SGDSK 


L 




SGPMGR 


1 




sGsvc ; 


i^ 




SGTHAP 


1 




SHOWCB 


17 




SKIP 21 




SMICR 


L,ll 




SNDITA2 


21 





STOPARU 21 


STOPLN 21 


STXIT 1 


SUPVR 1 


SYSCOM 1 


SYSIO 1 


TCLOSE 17 


TECB 1 


TERM 21 


TERMTBL 21 


TERMTBLD 21 


TESTCB 17 


TGROUP 20 


TIMESTMP 21 


TPEDIT 20 


TPIO 2 


TRANS 21 


TRANSLAT 20 


TRLIST 20 


TRN SLATE 20 


TRSRCTW 20 


TRSRCT3 20 


TRSSCTW 20 


TRSSCT3 20 


TRUNC 1 


TWA IT 20 


VIRTAD 1 


VSTAB 1 


WAIT 1 


WAITF 1 


WAITM 1 


WORD 21 



SNDZSC3 21 
SOURCE 21 
STARTARU 21 
START LN 21 
STCBD 21 
STDJC 1 
STEND 20 



WORDTBL 21 

WRITE 1 

WRU 21 
magnetic tape IOCS modules 7 
MAINT 1 

maintenance procedures 1 
MAPS 1 
MAXBUFS 2 
MAXCCB 2 
MAXJOBS 2 
MAXRJS 2 
MAXRW 2 
MCAR/CCH 1 
MCH 1 

MERGE function, use of 1 
messages, distribution program 1 
MICR 1 

minimum machine requirements 1 
MNOTES during supervisor assembly 
MODE 1 
MODEL 1 
MRMOD (magnetic character reader 

module) 13 
MTMOD (magnetic tape module) 7,i; 
multitasking 1 

NPARTS 1 
NTRKGP 2 
NUMDDKS 2 



OC parameter 1 

OLT 3 

OLTEP 19,1 

operational pack 1 

optical reader sample problems 13 
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optimum assignment of work files 1 
organization of the system pack 1 
ORMOD (optical reader module) , size of 
13 



Page pool 1 
PAGE IN 1 
parameters 

ALLOC 1 

ALLOCR 1 

ASSGN 1 

CONFG 1 

DPD 1 

DTFBT table requirements formula 20 

DVCGEN 1 

FOPT 1 

lOTAB 1 

IVP 3 

PIOCS 1 

POWER 2 

SEND 1 

STDJC 1 

SUPVR 1 

VSTAB 1 
partition save areas 1 
PC 1 
PCHADDR 3 
ED 1 
PDAID 1 
PFIX 1 
PHO 1 
physical and logical I/O assignments, 

sample problems 1 
physical transient overlap (PTO) 1 
PIOCS 1 

PL/I, IOCS modules 7 
planning 

libraries (operational pack) 1 

supervisor 1 

system generation 1 
POWER 

central system 2 

deleting phases and macros 2 

generating a small writer-only POWER 
system 2 

generating a small reader /writer 
POWER system 2 

generating POWER without Remote Job 
Entry 2 

generating POWER with Remote Job 
Entry (RJE) 2 

generating a small POWER RJE system 2 

IBM 2560, POWER support for 2 

IBM 3 525, POWER support for 2 

IBM 5425, POWER support for 2 

Library space requirements 2 

lixik— editing PO*'»ER for a supervisor 
without relocating loader 2 

local testing of POWER RJE 2 

phases and macros 2 

program generation parameters 2 

programming requirements 2 

program generation steps 2 

starting POWER 2 

storage estimates for a minimum POWER 
partition 2 



terminals supported 2 

total size of POWER partition 2 

with Remote Job Entry (RJE) 2 

POWPART 2 

printer support, IBM 3203, 3211, and 5203 1 

PRIORITY 2 

private libraries 1 

PRMOD (printer module) 1,7 

problem determination, IBM-supplied list 
for DOS/VS 1 

processing the distribution tape 1 

PRTY 1 

PTMOD (paper tape module) 15 

PTO (Physical transient overlap) 1 

PWR 3 



QFILE 2 
QTAM 21 
QTAM secondary storage requirements 



RDE (reliability data extractor) 1 

RDRCLOS 2 

READER 2 

real address area 1 

recorder file 1 

reliability data extractor (RDE) 1 

RELLDR 1 

relocatable library 

assembler 18 

BTAM 20 

common librarian modules 1 

compiler IOCS modules 7 

CORGZ 1 

CSERV 1 

DSERV 1 

DUMPGEN 1 

emulator modules, library blocks 4,5 

EREP 1 

ESTVUT 1 

IBM 3211 printer support 1 

IPL 1 

job control 1 

linkage editor 1 

MAINT 1 

MCAR/CCH 1 

module ID 1 

OLTEP 1 9 

PDAID 1 

QTAM 2 1 

RMS 1 

RSERV 1 

SSERV 1 

standard system dump 1 



translatinc s^'^stero d.umD 1 

utilities 22 
relocating load support 1 
replacing identiacl entries using 

merge function 1 
required IOCS modules 7 
RERUN 3 

restore back-up tape to disk 1 
restore card to disk 22 

secondary storage requirements 1 



'■"^ 
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restore system tape to disk 1 
restore tape to disk or data cell 22 

secondary storage requirements 1 
RETAIN 1 
RETRY 2 
RJE 2 
RJEND 2 
RMSR (ERRLOG) 1 
RSERV 1 
RSIZE 1 
RULES 

DVCGEN 1 

macros 1 

supervisor generation macros 1 
RWTAU 1 



SDAID 

transient 1 
SDMOD (sequential DASD modules) 7,16 
SDMODW 7 
SDMOD XX 7 
SELCH 1 
SEND macro 1 
SET 1 
SETIME 1 

Shared Virtual Area (SVA) 1 
size of supervisor 1 
SKSEP 1 
SLI 2 

source statement library 1 
source statement library macros 

BTAM macros 20 

components of 1 

QTAM 2 1 

supervisor generation 1,11,21 

supervisor communication 1 

system generation 1 
source statement library, 

IBM-supplied 1 
SSERV 1 
SSLNS 1 

standard label option 1 
standard system dump 1 
STDCARD 2 
STDJC 1 
STDLINE 2 
STXIT 1 
SUBLIB 2 
supervisor 1 

supervisor shipped by IBM 1 
SUPVR macro 1 
SVA 1 

switchable channels 1 
SYM 1 
SYSFIL 1 

system configuration 1 
system control 1 
system directory and library track 

capacities 1 
system distribution 

disk only users (2314) 1 

disk only users (3330) 1 

disk only users (3340) 1 

tape users (2314) 1 

tape users (2330) 1 



tape users (3340) 1 
system generation and maintenance 

procedure 1 
system I/O modules MTMOD 7 
system libraries 

directory capacities 1 

track capacities 1 
system utility program 22 



table requirements 

DTFCD 1 

DTFCN 1 

DTFDA 11 

DTFDU 9 

DTFIS 10 

DTFMR 1 1 

DTFMT 1 2 

DTFOR 13 

DTFPH 1 

DTFPR 1 

DTFPT 15 

DTFSD 16 

DTFSR 1 

DUMODFI 9 

DUMODFO 9 
TAPE 1 

TAPE (POWER parameter 2 
tape to data cell 22 
tape to disk 22 
tape to workfiles 

assembler 18 

modules 7 
tape, disk, and data cell 

configurations 1 
TEB 1 
TEBV 1 

teleprocessing 

(see BTAM or QTAM) 
time-of-day (TOD) clock support 
TOD 1 
TP 1 
TRACKGP 2 
transients, IBM-supplied 

$$A$SUP1 1 

$$ABERAA 1 

$$ABERAB 1 

$$ABERAC 1 

$$ABERAD 1 

$$ABERAE 1 

$$ABERAF 1 

$$ABERAG 1 

$$ABERAH 1 

$$ABERAI 1 

$$ABERAN 1,13 

$$ABERA1 1 

$$ABERA2 1 

$$ABERA3 1 

$$ABERA4 1 

$$ABERA5 1 

$$ABERA6 1 

$$ABERA7 1 

$$ABERP1 20 

$$ABERP2 20 

$$ABERP3 20 
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$$ABERP4 20 

$$ABERP5 20 

$$ABERP6 20 

$$ABERP7 20 

$$ABERP8 20 

$$ABERP9 20 

$$ABERRA 1 

$$ABERRB 1 

$$ABERRC 1 

$$ABERRD 1 

$$ABERRF 1 

$$ABERRG 1 

$$ABERRH 1 

$$ABERRI 1 

$$ABERRJ 1 

$$ABERRK 1 

$$ABERRL 1 

$$ABERRM 1 

$ $ABERRN 1 

$$ABERRO 1 

$$ABERRP 1 

$$ABERRQ 1 

$$ABERRS 12 

$$ABERRT 13 

$$ABERRU 15 

$$ABERRV 15 

$$ABERRW 1 

$$ABERRY 1 

$$ABERRZ 1 

$$ABERR1 1 

$$ABERR2 1 

$$ABERR3 1 

$ $ABERR4 1 

$$ABERR5 1 

$$ABERR7 1 

$$ABERZ1 1 

$$BATTNA 1 

$$BATTNB 1 

$$BATTNC 1 

$$BATTND 1 

$$BATTNE 1 

$$BATTNF 1 

$$BATTNG 1 

$$BATTNH 1 

$$BATTNQ 1 

$$BATTNR 1 

$$BATTNS 1 

$$ BAT TNT 1 

$$BATTNU 1 

$$BATTNV 1 

$$BATTNW 1 

$$BATTNX 1 

$$BATTNY 1 

$$BATTNZ 1 

$$BATTN2 1 

$$BATTN3 1 

$$BATTN5 1 

$$BBT3SC 20 

$$BBT3SI 20 

$$BCCHHR 1 

$$BCCPT1 1 

$$BCE0V1 1 

$$BCHKPD 1 

$$BCHKPE 1 

$$BCHKPF 1 

$$BCHKPT 1 

$$BCHKP2 1 

$$BCHK3G 1 



$$BCISOA 1 

$$BCLOSE 1 

$$BCLOSP 1 

$$BCL0S2 1 

$$BCL0S3 1 

$$BCMR01 11 

$$BCMT01 1 

$$BCMT0 2 1 

$$BCMT0 3 1 

$$BCMT0 4 1 

$$BCMT05 1 

$$BCMT06 1 

$$BCMT0 7 1 

$$BCQC01 21 

$$BCQC02 21 

$$BCQC03 21 

$$BCTC01 21 

$$BCVSAM 17 

$$BCVS01 17 

$$BCVS0 2 17 

$$BDMPBC 1 

$$BDMPDC 1 

$$BDMPVA 1 

$$BDUMP 1 

$$BDUMPB 1 

$$BDUMPD 1 

$$BENDFF 1 

$$BENDFL 1 

$$BENDQB 1 

$$BEOJ 1 

$$BE0JS1 1 

$$BE0JS2 1 

$$BEQJ1 1 

$$BE0J2 1 

$$BE0J2A 1 

$$BE0J3 1 

$$BE0J3A 1 

$$BE0J4 1 

$$BE0J5 1 

$$BE0J7 1 

$$BERPTP 15 

$$BERRTN 1 

$$BETPRT 20 

$$BFCB 1 

$$BFCB3 1 

$$BFCB5 1 

$$BHDRCK 20 

$$BIIQBD 4 

$$BIIQBS 4 

$$BIIQMW 4 

$$BIIQSD 4 

$$BIIQSS 4 

$$BIIQT1 4 

$$BIIQT2 4 

$$BIIQT3 4 

$$BIIQT4 4 

$$BIIQT5 4 

$$BIIQT6 4 

$$BIIRBD 5 

$$BIIRBB 5 

$$BIIRMW 5 

$$BIIRSD 5 

$$BIIRT1 5 

$$BIIRT2 5 

$$BIIRT3 5 

$$BIIRT4 5 

$$BIIRT5 5 

$$BIIRT6 5 
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$$BIISAL 


6 


$$BIISAS 


6 


$$BIISA2 


6 


$$BIISBI 


6 


$$BIISBS 


6 


$$BIISCC 


6 


$$BIISCD 


6 


$$BIISCF 


6 


$$BIISCS 


6 


$$BIISDI 


6 


$$BIISDP 


6 


$$BIISEX 


6 


$$BIISFM 


6 


$$BIISLE 


6 


$$BIISM1 


6 


$$BIISM2 


6 


$$BIISM3 


6 


$$BIISM4 


6 


$$BIISPR 


6 


$$BIISRL 


6 


$$BIISTD 


6 


$$BIISTS 


6 


$$BIISUC 


6 


$$BItSUM 


6 


$$BIISUR 


6 


$$BILSVC 


1 


$$BINDEX 


1 


$$BJCOPT 


1 


$$BJCOPI 


1 


$$BJDUMP 


1 


$$BJIBFF 


17 


$$BJIBOO 


17 


$$BLEPRT 


20 


$$BLOPEN 


20 


$$BLSTIO 


1 


$$BLVTOC 


1 


$$BMMR20 


11 


$$BMSGWR 


1 


$$BMVKEY 


1 


$$BOCISC 


17 


$$B0CPM1 


1 


$$B0CPM2 


1 


$$B0CPT1 


1 


$$B0CPT2 


1 


$$B0CPT3 


1 


$$B0CPT4 


1 


$$BOCP01 


1 


$$BOCP02 


1 


$$BOCP0 3 


1 


$$B0CP11 


1 


$$B0CP12 


1 


$$BOCRTA 


1 


$$BOCRTB 


1 


$$BOCRTC 


1 


$$BOCRTD 


1 


$$BOCRTE 


1 


$$BOCRTF 


1 


$$BOCRTG 


1 


$$BOCRTH 


1 


$$BOCRTK 


1 


$$BOCRTL 


1 


$$BOCRTM 


1 


$$BOCRTN 


1 


$$BOCRTO 


1 


$$BOCRTP 


1 


$$BOCRTQ 


1 


$$BOCRTR 


1 


$$BOCRTS 


1 



S$BOCRTT 


1 


$$BOCRTU 


1 


$$BOCRTV 


1 


$$BOCRTW 


1 


$$BOCRTX 


1 


$$BOCRTY 


1 


$$BOCRTZ 


1 


$$B0CRT1 


1 


$$B0CRT2 


1 


$$B0CRT3 


1 


$$B0CRT4 


1 


$$B0CRT5 


1 


$$B0CRT6 


1 


$$BODACL 


1 


$$BODADE 


17 


$$BODADS 


17 


$$BODAIN 


1 


$$B0DAI1 


1 


$$B0DA01 


1 


$$B0DA02 


1 


$$B0DA03 


1 


$$B0DA04 


1 


$$B0DI01 


1/9 


$$B0DI02 


1,9 


$$B0DI03 


1,9 


$$B0DI04 


1,9 


$$B0DI05 


1.9 


$$B0DI06 


1,9 


$$B0DI07 


1,9 


$$B0DI08 


1,9 


$$BODMSG 


1,9 


$$B0DMS2 


1,9 


$$BODQUE 


1 


$$BODSMW 


1 


$$BODSMO 


1,9 


$$BODSPO 


1,9 


$$BODSPV 


1 


$$BODSPW 


1 


$$BODUCP 


1,9 


$$BOFLPT 


1 


$$BOIS01 


1 


$$BOIS02 


1 


$$BOIS03 


1 


$$BOIS04 


1 


$$BOIS05 


1 


$$BOIS06 


1 


$$BOIS07 


1 


$$BOIS08 


1 


$$BOIS09 


1 


$$BOIS10 


1 


$$BOMRCE 


1 


$$BOMR01 


11 


$$B0MSG1 


1 


$$B0MSG2 


1 


$$B0MSG3 


1 


$$B0MSG4 


1 


$$B0MSG5 


1 


$$B0MSG6 


1 


$$B0MSG7 


1 


$$BOMT0M 


1 


$$BOMT0W 


1 


$$BOMT01 


1 


$$BOMT0 2 


1 


$$BOMT0 3 


1 


$$BOMT04 


1 


$$BOMT0 5 


1 


$$BOMT06 


1 


$$BOMT07 


1 


$$BONVOL 


1 
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$$BOOR01 


13 


$$BOPEN 


1 


$$BOPENC 


1 


$$BOPEND 


1 


$$BOPENR 


1 


$$BOPEN0 


1 


$$B0PEN1 


1 


$$B0PEN2 


1 


$$BOPIGN 


1 


$$BOPNLB 


1 


$$B0PNR2 


1 


$$B0PNR3 


1 


$$BOQO01 


21 


$$BOQO0 2 


21 


$$BOQO0 3 


21 


$$BOQO04 


21 


$$BOQO05 


21 


$$BOQO0 6 


21 


$$BOQO0 7 


21 


$$BOQO0 8 


21 


$$B0RTV1 


1 


$$B0RTV2 


1 


$$B0SDC1 


1 


$$B0SDC2 


1 


$$BOSDEV 


1 


$$B0SDI1 


1 


$$B0SDI2 


1 


$$B0SDI3 


1 


$$B0SDI4 


1 


$$B0SD01 


1 


$$B0SD02 


1 


$$B0SD03 


1 


$$B0SD04 


1 


$$B0SD05 


1 


$$B0SD06 


1 


$$B0SD07 


1 


$$B0SD08 


1 


$$B0SD09 


1 


$$B0SDW1 


1 


$$B0SDW2 


1 


$$B0SDW3 


1 


$$BOSDdO 


1 


$$BOSD01 


1 


$$BOSIGN 


1 


$$BOTC01 


20 


$$BOTC02 


20 


$$BOUR01 


1 


$$BOVDMP 


1 


$$BOVSAM 


17 


$$BOVS01 


17 


$$BOVS0 3 


17 


$$BOWDMP 


1 


$$B02321 


1 


$$BPCHK 


1 


$$BPDAID 


1 


$$BPDMPC 


1 


$$BPDUMP 


1 


$$BPSW 


1 


$$BQCNCL 


21 


$$BQCNCM 


21 


$$BQHDCK 


21 


$$BQWTRA 


21 


$$BQWTR1 


21 


$$BQWTR2 


21 


$$BQWTR3 


21 


$$BQ1030 


21 


$$BQ1050 


21 


$$BQ1060 


21 



$$BQ2260 




$$BQ2740 


21 


$$BRELSE 


1 


$$BRESPL 


20 


$$BRMSG1 




$$BRMSG2 




$$BRSTRT 




$$BRSTR2 


1 


$$BRSTR3 


1 


$$BRSTR4 


1 


$$BSDAID 


1 


$$BSDRUP 


23 


$$BSETFF 


1 


$$BSETFG 


1 


$$BSETFH 


1 


$$BSETFL 


1 


$$BSETL 


1 


$$BSETL1 


1 


$$BSYSWR 


1 


$$BTCLOS 


17 


$$BTCNCL 


20 


$$BTERM 


1 


$$BTMEBG 


20 


$$BT1030 


20 


$$BT1050 


20 


$$BT1060 


20 


$$BT2260 


20 


$$BT2740 


20 


$$BT2848 


20 


$$BUCB 


1 


$$BUCB3 


1 


$$BUCB5 


1 


$$BUFLDR 


1 


$$BUFLD1 


1 


$$BUFLD2 


1 


$$BVALAD 


17 


$$B3540I 


1,9 


$$B3540O 


1/9 


$$B35400 


1/9 


$$RAST00 


1 


$$RAST01 


1 


$$RAST02 


1 


$$RAST03 


1 


$$RAST04 


1 


$$RAST05 


1 


$$RAST06 


1 


$$RAST07 


1 


$$RAST08 


1 


$$RAST09 


1 


$$RAST10 


1 


$$RAST11 


1 


$$RAST12 


1 


$$RAST13 


1 



transients , required 1 
translating system dump 1 

TRKHLD 1 

TSWTCH 1 

TTIMER 1 



utilities,, system 
UTL 3 
UTLDA 3 
UTLDRT 3 
UTLDV 3 
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UTLT 


3 


UTLTA 


3 


UTLTM 


3 


UTLZ 


3 


UTLZA 


3 


UTLZCN 


3 


UTLZRT 


3 



values for communication 

line group table 21 
VERIFY (IVP option) 3 
Virtual Address Area 1 

Virtual Storage Access Method (VSAM) 17 
VOLID 3 
VSAM 17 

VSIZE parameter 1 
VSTAB macro 1 
VTOC display 1 



WAITM 1 

warning diagnostics 18 
workfile assignments 1 
workfile MTMOD 1, 12 
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DOS/VS System Generation READER'S 

COMMENT 
FORM 

GC33-5377-1 



This sheet is for comments and suggestions about this manual. We would appreciate your 
views, favorable or unfavorable, in order to aid us in improving this publication. This form 
will be sent directly to the author's department. Please include your name and address if 
you wish a reply. Contact your IBM branch office for answers to technical questions about 
the system or when requesting additional publications. Thank you. 



Your comments* and suggestions: 



* We would efqpedaUy appreciate your comments on any of the following topics: 

Clarity of the text Accuracy Index Illustrations Appearance Paper 

Organization of the text Cross-references Tables Examples Printing Binding 



GC33-5377-1 



YOUR COMMENTS, PLEASE . . . 

This manual is part of a library that serves as a reference source for systems analysts, 
programmers and operators of IBM systems. Your answers to the questions on the back of this 
form, together with your comments, will help us produce better publications for your use. Each 
reply wili be carefully reviewed by the persons responsible for writing and publishing this 
material. All comments and suggestions become the property of IBM. 

nease note: Requests for copies of publications and for assistance in utilizing your IBM sys- 
tem should be directed to your IBM representative or to the IBM sales office serving your 
locality. 
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DOS/VS System Generation 

© Copyright IBM Corporation, 1973 

This Technical Newsletter, a part of release 29 of the IBM Disk Operating System/Virtual Storage, 
provides replacement pages for your publication. These replacement pages remain in effect for subsequent 
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Cover, 2 
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Summary of Amendments 

— Replacement of the VSAM section (book module 17) by a VSAM. Independent Component 
Release. 

— Miscellaneous corrections. 
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